\tf : 



• f 



J 



u\)0 




33A^, 



h^ 



3 C 

r>3 "> 



V J(T 



J 3 ! 



s no ? 5 



ERRATA SHEET 



PAGE 9 . , ^ .«_,_,_, 4.u 

Add a-fter (To suppress an automatic "AUTO" -function, hold down the 

"ENTER" key during power up.) 

To input the date and keep the "AUTO" -function during power-up, 

terminate the date entry with <BREAK>* 

I 

PAGE 18 

Add the -following at the end of KEYBRD: 

To de-feat KEYBRD "ON" attributes during power up, hold down any 

combination o-f the following: 

Lower case left-arrow 

Graphics driver "CLEAR" key 

Repeating keyboard right-arrow 

Blinking cursor down arrow 

Blinking character up-arrow 

MULT I DOS keyboard <SHIFT> 

Under ^SPOOL/CMD, items 2, 3, 4, 5, and 6 have been deleted. (Use "FORMS" 
■for pagenation). Change the paragraph below item 7 to read: 
The SPOOLER will now commence operation and control of any printer 
output . 

To suspend output press shift <BREAK>. You will be asked if the buffer 

is to be saved. A "Y" response will save the buffer contents, and an "N" 

response will reset the pointers and send a carriage return to the 

printer. 

The next query to appear will be: 

'SPOOL? ' 

Enter "Y" if you want to continue SPOOLING. An "N" response will unlink 
the SPOOLER from the printer DCB and restore TOPMEM if possible. 

Delete the next two paragraphs. (They belong under FORMS.) 

PAGE 37 

Second paragraph - delete "and provide." at the end. 

PAGE 46 

Last line should end with 'GOTO 15'. 

PAGE 65 

Acceptable syntax for PUT should be: 

PUTt#3buf t,rec3 

PAGE 66 

Correct syntax for GET should be: 

RFi raibuf r .reel 
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IMPORTANT NDTICE 

Cosmopolitan Electronics Corporation distributes all B °J^- ^ 
an "AS IS" basis without warranty. Cosmopolitan El o c 

Corooration shall not be liable or responsible, to the Phaser 
Corporation sna, damage caused or alleged to be 

with respect to liability, loss, ur y .-netware which 

!-lr.e^d directly or indirectly by the use of this software, wnicn 
"^udes but is not limited to any interruption of service, 1°« 
lousiness: or anticipatory profits, or conseguenti al damage 
resulting from use o-f this software. 
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What is MULT I DOS 



This operating systpm Is the underlying software required to Interface user 
programs with the hardware. It was written with the intent of user oriented software 
without being superfluous. 

The word format was used here to describe that particular systems' logic In 
communicating with Its diskette. 

Since we are no experts on other operating systems, we can only tell you what 
MULTIDOS Is capable of doing. To best describe MULTIDOS' interface capabilities the 
diagram shown on the opposite oage indicates what can be read/written to. 
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NOTE 1: These systems will hive their address marks changed. 



NOTE 2: EXTREME CAUTION: MULTIDOS does 
sufficient space is avalable via NEWDOS/80, 
free space (except CAT). 



not know the track count. Re sure 
MULTIDOS does not report correct 
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S = Single Density D = Double Density P - P Density (Modified Double Density) 
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MULT I DOS Uniqueness 



Here is a list of items you have available with MULTIDOS that have 
yet to appear in other operating systems. 



FUNCTION 

Repeat Last DOS Command 
Multiple DOS Command 
APPEND checks LRL 
ATTRIB to Lockout 
Blind AUTO 
Invinceable AUTO 
BOOT, a HI SPEED 
Nested DO'S 
So-ftware powerup 

Executable DEBUG 
Alphabetized Directory 
DUMP to 3000H 

Totals FREE 

HASH Codes 

Keyboard attributes 

LOAD to S200H 

TOPMEM 

Auto-multiple density 

BACKUP GRANULES FROM 

BAD SOURCE 

COPY 1 drive 

COPY only if sufficient 

space 

LOCK out GRANULES vs 

TRACKS for FORMAT 

Graphics driver 

Full function single 

step BASIC 

Zero arrays 

Delete arrays 

Sort 

Used variables displayed 

Transfer to Level II 

Folded CMD"uuuuu" 

Fi nd 

Intelligent GLOBAL EDITOR 

String packer 

Line splitter 

Line merger 

Renumber tc line 

Renumber Packed Strings 

Lists GRAPHICS 

Automatic HI SPEED 

Full time Blinking cursor 

Won't hang if no printer 

Full time Repeating Keys 

Menu driven Copy by file 



MULTIDOS 


TRSDOS 


NEWDOS 80 


DOS PLUS 


LDOS 


YES 


NO 


use "R" 


NO 


NO 


YES 


NO 


NO 


NO 


TYPE AHEAD 


YES 


NO 


NO 


NO 


YES 


YES 


NO 


YES 


NO 


NO 


YES 


NO 


NO 


NO 


NO 


YES 


NO 


SYS opt. 


NO 


NO 


YES 


NO 


NO 


NO 


NO 


YES 


NO 


Repl aces 


NO 


NO 


YES 


NO 


NO 


NO 


NO 


YES 


NO 


-—__ NO ' ! 


NO 


NO 


YES 


. NO 


NO 


NO 


NO 


YES 


NO 


NO 


NO 


NO 


YES 


NO 


YES 


NO 


NO 


6 Eo Qa& 


NO 


NO 


V EZ. S3 


NO 


YES 


NO 


NO 


NO 


NO 


YES 


NO 


SUPER ZAP 


NO 


NO 


YES 


NO 


SYS opt. 


NO 


SYS opt. 


YES 


NO 


' YES 


NO 


NO 


YES 


NO 


YES 


NO 


YES 


YES 


NO 


PDRIVE 


SIN/DBL 


SIN/DBL 


YES 


NO 


NO 


NO ; 


NO 


YES 


NO 


YES 


YES (limited) YES 


YES 


NO 


NO 


NO 


NO 



YES 



NO 



NO 



NO 



NO 



YES 


NO 


NO 


NO 


NO 


YES 


NO 


NO 


NO 


NO 


YES 


NO 


NO 


NO 


NO 


YES 


NO 


YES 


NO 


NO 


YES 


NO 


YES 


NO 


NO 


YES 


NO 


NO 


YES 


NO 


YES 


NO 


NO 


NO 


NO 


YES 


NO 


NO 


NO 


YES 


YES 


NO 


YES 


NO 


NO 


YES 


NO 


YES 


NO 


NO 


YES 


NO 


NO 


NO 


NO 


YES 


NO 


NO 


NO 


NO 


YES 


NO . 


NO 


NO 


NO 


YES 


YES 


NO 


YES 


YES 


YES 


NO 


NO 


NO 


YES 


YES 


NO 


NO 


NO 


NO 


YES 


NO 


NO 


NO 


NO 


YES 


NO 


NO 


NO 


NO 


YES 


NO 


NO 


NO 


NO 


YES 


NO 


NO 


YES 


NO 


YES 


NO 


NO 


NO 


NO 



FIRST THINGS FIRST 

The first thing you must do with your MULTIDOS diskette, is make a backup 
A blank diskette without the write protect notch covered is required for this 
procedure. 

i 

LEAVE THE WRITE PROTECT TAB ON THE MULTIDOS DISKETTE. 

1. Turn on your expansion Interface. 

2. Turn on your peripherals (disk drives, printer, etc.) 

3. Turn on your CPU/keyboard. , 

4. Insert your MULTIDOS diskette into drive 0. 
(open door, insert, close door) 

5. Press the reset button. 

uniVmrtc" J ?" thC rCSCt bUtt ° n ' the di$p,ay W,U ideate that this is a 
MULNU05 diskette and will prompt you to input today's date. MULTIDOS will 
date your files with the date you have just entered. If you don't care about 
dating your files press "BREAK" or "ENTER". 

Type BACKUP, then press the "ENTER" key. 

Answer 'Which drive contains the source diskette?' 
with 

Answer "Which drive for the destination diskette?' 
with 1 if you have 2 drives otherwise 0. 

The next prompt will be: 

•Press "ENTER" when the source diskette is in drive 0'. 

Press the "ENTER" key. 

At this point MULTIDOS will examine the source diskette for track count and 
density. The track count will be 35. The density will be the one you ordered. 

Answer TVack count for the destination diskette ( 35 to 96 )?' 

with the maximum track capacity of the destination drive (usually 35, 40, or 

If you only have a 35 track drive you cannot make a 40 track backup! 

MULTIDOS will format the blank diskette, then proceed to duplicate the 
contents of your MULTIDOS diskette. 

If you are only using one drive, BACKUP will tell you when to insert the 
blank (destination) diskette, and when to re-insert your MULTIDOS (source) 
diskette. During a one drive BACKUP, you will have to exchange the diskettes 
several times. 

When BACKUP has completely duplicated your MULTIDOS diskette 
■Completed ' 

Press "ENTER" when a MULTIDOS system diskette is in drive 0' 
will be displayed. Press the "ENTER" key. 

It is highly recommended that your original MULTIDOS diskette be stored in a 
safe place and all future backups made from the copy you just produced. 
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What It MULTIDOS 

One of the purposes of MULTIDOS, is •• link to all the Model I DOS's on the 
mark e t. 

<• 

MULTIDOS will permit you to read/write/copy to/from any Mode! ' I 
single/double density operating system configured as purchased. (NEWDOS80/2.0 
double density data diskettes can only be read). MULTIDOS Is capable of 
reading/writing/copying to/from several Model III operating systems diskettes. 
(NEWDOSSO/2.0 and TRSDOS are excluded). 

In addition, MULTIDOS has an excellent extended disk basic, SUPERBASIC, 
which has a super fast string sort and leaves the user with more than 40K 
{48K RAM) of free memory. What was sacrificed In obtaining the 40K - 
NOTHING! In fact, SUPERBASIC has several Innovative and useful functions 
which the programmer/user will find Invaluable. One of which is an intelligent 
global editor. This is the only one available which will allow the user to 
change a "T" variable without changing the «T« in a key word as "PRINT", and 
the letter "T" embedded within quotes. However, it will allow the user to 
change "PRINT" or any character within quotes independently If desired. 
Another innovation Is the abii.ty to chain basic programs maintaining all 
scalar and array variables. 

SUPERBASIC maintains all of the syntax developed for the Model I, with one 
exception - octal/hex constants. SUPERBASIC uses the "H" vs the "0" as 
the optional character whereas TRSDOS basic uses the "0» vs the "H" as the 
optional character. 



EXAMPLE: 

TRSDOS 

&H4000 = 16384d 
&4 000 * 2048d 
&076 or 476 * 62d 



SUPERBASIC 

&H4000 or A4000 = 16384d 

£076 = 62d, 476 = 118d 



Also there are major difference In the »CMD" functions. SUPERBASIC 3.0 
which was developed on July 7, 1979, started using several "unused" letters as 
special functions. Subsequently NEWDOS80/1, TRSDOS Model III, VTOS, LDOS 
and DOSPLUS have added their own. 

Here are SUPERBASIC'* "CMD" functions. 



INTRODUCED 


CMD 


ADDIT 
Input 


7/06/79 


C 


No 


ORIGINAL 


D 


No 


ORIGINAL 


E 


No 


2/01/81 


K 


Yes 


2/01/81 


L 


Yes 


2/01/81 


. M 


Ye s '. 


2/01/81 


' n" 


Yes* ' 


7/06/79 





No---' 


3/14/81 


Q 


Yes 


ORIGINAL 


R 


No 


ORIGINAL 


S 


No 


ORIGINAL 


T 


No 


9/01/81 


V 


No 


7/06/79 


X 


No 



Deletes spaces ^'linefeeds from program, 

Loads DEBUG 

Displays last DOS error. . 

Zeroes target arrays. ..• 

■Deletes target arrays. .0. 

Moves program line. .'•!;'•.' '.'■'• 

Duplicates program line. .' " ; - ; . . 

Opens an additional file buffer. .' .' 

Sorts string arrays. 

Turns on Interrupts. 

Re turns to DOS. 

Turns, off interrupts. 

Lists currently assigned variables. 

Transfers basic program to Level II. 



NOTATION 



Symbol 

<ENTER> 

<BREAK> 

<SPACE> 

<COVMA> 

f I lespec 

dr I vespec 

II 

a space 
punctuation 
s ingle quote ' 






Meaning 

Press the "ENTER" key. 

Press the "BREAK" key. 

Press the ■SPACE-BAR*. 

Press the ■,.■ key. 

A valid MULTIDOS file. 

A particular, disk drive number (0,1, 2„ or 3) 

Brackets enclose optional parameters. 

The ■[• and "I s are not typed In. 

At least one mandatory space. 

Must be entered as shown. 

Encloses MULTIDOS responses which are directed 

to the display. 

The triple periods indicate you may optionally 

repeat the last item in brackets. 



G0MttAM>S 
MULTIDOS Is similar to other DOS's. Whenever the prompt,, 

Multidos ready 

* 

is displayed, you may enter a operator command. In the simple form of as 
little as one word followed by <ENTER>. 

EXAMPLE: 

FREE<ENTER> 

The above command instructs MULTIDOS to display the amount of free 
graiidles remaining on all drives. 

All of the MULTIDOS commands terminate with <ENTER>. 

The maximum length of a command is 63 characters followed by <ENTER>. 



When specifying a diskette file the term ■filespec" will be used In this 
reference manual. The "fllespec" will be as follows: 



FILENAME! /EXTJ (.PASSWORD] [:DJ 



FILENAME is the name of the diskette file. Valid filenames 
consist of at least one and not more than eight characters. 
The first character must be alphabetic (A-Z), and the remaining 
characters can be alphabetic or numeric (0-9). 
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/EX1 I, an optional extension to the FILENAME and consists of the 
slash character (/) and at least one, but not more than three 
characters. The first of these characters must be alphabetic 
lhe remaining characters can be alphabetic or numeric. All f|| e 
extensions, except «/CMD", must be entered for proper 
identification of the file. More on this later. 

.PASSWORD is an optional password consisting of the period symbol 
and one to eight characters. The first character must be 
alphabetic and the remaining can be alphabetic or numeric. 

:D Is an optional drlvespec consisting of a colon followed by 
a number in the range of to 3. 7 . ' 

fr^Un n ° ,e tHaX * f "" PeC d °" N ° T h2Ve "spaces on It. Spaces are 
treated as separators by MULTIDOS. If spaces are in a filespec, only the 
contents preced.ng the space will be Interpreted as the filespec. 

The PASSWORD is NOT part of a filespec's uniqueness. The followin R are 
interpieted as the same filespec: 

WONDER. BOY WONDER. WOMAN WONDER. FULL 

However, the following are unique filespecs: 

WONDER:! WONDER: 2 WONDER: 3 

exL^™< S '° n V n i d f CnCraI conform * nc » «o"-r micro's users,. the following 
extentions are typical. h 



/ASC 
/ASM 
/BAS 



A basic program stored in ASCII form. 
An assembly I anguage source fll*. 
A ba$ ' c program stored in compressed format, 
•:;'•:■ ' C,M A fie created via "DUMP*. 

V* ' i?^ A mach lne language executable file. 

r • /KtL A relocatable object file. 7 '-, > . - 

'< ; ' SYS An operating system's overlay. 

1 ., 7TXT An ASCn »«» file. (Typically sequeni'lal files) 

z*:T> n t\^:z: thc - f - i «" •-«-«- ^ « *.. ^ . fi,es P e C 

EXAMPLE: . v : • : . ... : ;. . ' . 

VFU<EN7ER> . ' . . ' ' ";■ ^- " '* " '. "' 

■ r • .-, -i -.-.v , • .. : ■ i. " • 

VFuIcM D S Wm add thC eXteni '° n ./ CMD l ° VFU « the " ,0ad > nd ""ate the file 

' : ■'■ • !!lth°0 jf/.V fM ,,n * dr,v "P ec '" MULT,D OS wli!'V«rch all drives starting 

d^rvesLc MlJTIDor PC m entered \" Y0U " e ,n, "» ,,z,n S * ™«P«e without a 
dnvespec, MULTIDOS will search for the first drive without a write protect 






I » .1 

More on COMMANDS | 

Multiple DOS commands are allowed when separated by a comma and no \ 

spaces. I 

EXAMPLE: ' I 

FREE,CLOCK,BASIC<ENTER> ' \ 

1. Will display the free granules and free file spaces on 

alt mounted diskettes. . | 

2. Displays the real time clock. Vj : - ... . • I 
3« Loads and executes SUPERBAS1C . ' * ' • \ ' 

'■•■ . , . " *• ■■'".": ' *• i 

MULTIDOS will repeat the last DOS command If <ENTER> Is the only response -* \ 

to the "Multldos ready" prompt. ■ I 

EXAMPLE: •••■_"... | 

DIR :1<ENTER> . ! 

Followed by <ENTER> will again display the directory of the diskette in 
DRIVE 1. ' * 

NOTE: The diskettes may be changed between the <ENTER>'$. 

To "ERASE" the last DOS command press the "BREAK" key. 

SPECIAL UNIVERSAL COMMANDS 

I - MIGHTY MULTI. 

This special overlay will permit you to copy files, display a directory, kill 
files, and list files from within any program in which the interrupt service is 
active. 

This command will be activated if the following conditions are met. 

1. Interrupt service is active. 

2. Drive motors have stopped. 

3. Simultaneous depression of the ":■ and ";■ keys. 

This command will exit on one of the following: 

1. The "BREAK" key is pressed. 

2. The "I" character Is the first input character. 

However, upon exit an extraneous key input may be present. 

The syntax for the various functions Is accomplished with a single letter and 
no connectors., (eg. TO) 

la - COPY - Copies files, "C" 

C fileone:d filetwo:d 

Please note t':e connector 'TO 1 is not part of this command syntax, and the 
first blank is optional. Although the drive numbers are optional, the filespecs 
are nandatory. (C fileone.l :2 is invalid) 
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lb - DIRECTORY - Dl«n!».,< , ax l 

Displays a diskette directory, »D» 

D:n or Dn 

" « 0. 1, 2, or 3, which represents the drive number. 

Ic - KILL - Deletes flle/»K". 

K filespecid \ ., - : . . . • . 

Id - LIST - List a file to the Display, i**- " " ; 

L fllespecrd 

T "" 8 "" ^ '•-''•'"'"' '■""•■"' " >"e SPACED ,. „.,,, , ow „. 

11 - IKL Dump ,h. „ld.o contents to the print,,. 

JKL = The »rn, u tt»n«„ ui depression of ,„, ;> K ^ L ^ 

Graphic blocks are converted .to the ".• character If 

happen, use the -HJK- command., •, ch \ racter - " you do not, want thi, to 

to prematurely terminate this function, <BREAK>. ' 

'" - HJK Dump display contents to printer, Including graphics. 



HJK = The simultaneous depression of the H A * K k «ys. 

ili command is similar' to the IKL r« m l '/*'"'" " 

"• <>• "nt to the printer Instead ofT, 7 ' * X " Pt that graphlc$ ^"acter, 
P inter Instead of being converted to •.» characters 



This 
w 




!'..f\'. VWW ■• • 
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LIBRARY COMMANDS 



The following commands are MULTIDOS library commands and are normally 
entered after the "Multidos ready" prompt has been received. 

A mandatory space is required after all library commands in which there are 
additional parameters or arguments. 

EXAMPLES: 

(1) DATE 09/01/81<ENTER> 

This establishes September 1, 1981 as the current RAM date. 

(2) DATE<ENTER> 

This displays the current RAM date in the format mm/dd/yy. 

Whenever the term -switch" is part of a MULTIDOS library command line, It 
represents an ON or OFF condition. If the "switch" is left out, ON will be 
invoked. 

The acknowledged responses are: 

(Y) = yes, on (N) = no, off 

(YES) = yes, on (NO) = no# off 

(ON) = yes, on (OFF) = no , off 

* 

Please note the required «(» and ")" surrounding the switch parameter. 

EXAMPLE: 

(1) BREAK (N)<ENTER> 

(2) BREAK (Y)<ENTER> or BREAK<ENTER> 

Example one will disable the "BREAK" key, and example two will enable the 
"BREAK" key. 



APPEND Appends a file to the end of another file. 

APPEND filespecl to filespec2<ENTER> 

APPEND allows you to add filespecl to the end of filespec2. filespecl is not 
affected by this command. 

NOTE: The disk which contains fllespec2, must not be write protected and 
must have at least enough free space to lengthen filespec2 by the length of 
filespecl, and both fllespecs must have the same logical record length. 

Be very careful with basic programs. Both should be ASCII files and the line 
numbers In filespecl should be higher than those of filespec2. 
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LIBRARY COMMANDS 
EXAMPLE: 

APPEND CLASS2/TXT to STUDENTS/TXT<ENTEK> 

l^JJ 1 : S , T k UDEN I S/ J" """ haVC thc ""«•"«» of r.|. CLASS2/TXT 
added to thc end. The f„. CLASS2/TXT will r* m J U nc^\l 

ATTRIB Assigns fllespec attributes. 

ATTRIB fllespec (param[,param...J)<ENTER> 
This command sets Hie protection attributes, 
param Can be any of the following: 



V 

A=pw 
U=pw 
P=level 

LEVEL 

KILL 

RENAME 

WRITE 

READ 

EXEC 

NONE 



The file is Invisible to the n „r m ,i a, 

The file is vi,lhl .u ' d ' rector y corrmand. 

pw = The new access password.""*' ' recsor ^ =°™und. 

pw « The new update password! 

level » The protection level. 



VALUE ACCESS PASSWORD PRIVILEGE 



1 
2 
4 
5 
6 
7 



TOTAL ACCESS 

RENAME, WRITE, READ, EXECUTE 

WRITE, READ, EXECUTE 

READ, EXECUTE 

EXECUTE ONLY 

LOCKED OUT 



I' a file has a protection level of WRITF mi «. 

£ levels equal to or higher than WRITE ' I.e. REAo'executf"", 8 ? "* " y ° f 

: h pdate cc P ^w p ;r ord - The "■• •■-"•' >-«^^ 

-.^"nieV^'-ce^" Zl^TrUZ %" "" >~ ""' 
operation with the file. require the access password for any 

"•I files h & v c 2n area** j , 

blank, The - D ,R- comm J"^.^^^^ ^ dCfaU,t Pa "* 0rd '» « 

which have a non-blank update L J l h ,! h P l ? tee,,0n ,CVC ' for »» "«•» 

by -P-X- to the right of', he fie ame\ n rc $ i'VT" ""' lnd ' CatCd 
value. nename, whereas X Is the protection level 

EXAMPLES: 

(1) ATTRIB FILEA/BAS (A=,U=S AM,P=READ)<ENTER> 
FILEA/BAS can be executed \ n *A-A 

•'it. ■» tii. ni* rename,', "k^ 1 iVm.",:'""" "»"•"•- T » 

must be used. fl,e ' tnc Password *SAM« 



(2) ATTRIB FILE8/BAS (V)<ENTER> 



FILEB/8AS is visible and will h. a- , 

is issued. W "' bC d,s P'»yed when the -OIR- command 
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LIBRARY COMMANDS 
AUTO Automatic command after reset. 

' AUTO( DOSCMDJ [linefeed DOSCMD] <ENTER> 

AUTO provides for automatic operation of one or more MULTIDOS commands or 
executable command files upon power-up. The commands or executable 
command files are executed in sequence immediately after power-up. 

DOSCMD is any valid MULTIDOS library command or a filespec for an 
executable command file. 

To provide for multiple auto commands, Insert a linefeed (down arrow) 
between each MULTIDOS command or filespec you want executed upon 
power-up. — — 

A maximum of 32 characters after the "AUTO ■ including blanks,' linefeeds, . 
and the terminating <ENTER> are allowed. If your entry exceeds 32 
characters, the 32nd character will be replaced with an <ENTER> and any 
additional characters will be disregarded. 

Since the "AUTO" command writes to the directory, the diskette must not be 
write protected when the "AUTO" command is set up or removed. 

To delete an automatic power-up sequence, type: 

I 

AUTO<ENTER> 

To suppress an automatic "AUTO" function, hold down the "ENTER" key during 
power-up. 

EXAMPLES: 

(1) AUTO DIR<ENTER> 

On future power-ups the directory will automatically be displayed 
after 'DIR' appears on the display. 

(2 ) AUTO 
CLOCK<LINEFEED> 
BASIC RUN"TEST" <ENTER> 

On future power-ups the real time clock will be displayed, BASIC 
will be loaded, the program "TEST" will load and run. You will see 
•CLOCK' displayed, then 'BASIC'RUN"TEST" ' 

To-lnhiblt the suppression of the "AUTO" function, key in an "I" (exclamation 
mark - shifted "1" on your keyboard) as the first character after the 
mandatory space following "AUTO". 



LIBRARY COMMANDS 



EXAMPLE: 

- AUTO IBASIC<ENTER> 



Orv subsequent power ups, BASIC will be loaded after "BASIC 
Is displayed, whether the <ENTER> key U he!d down or „ oU 

To Inhibit dlsplaylni the AUTO DOSCMD(s), place a ■#■ (pound sign, shifted -3" 
on your keyboard) in front of the first DOSCMD. 

EXAMPLE: 

AUTO #BASIC<ENTER> 

On subsequent power ups BASIC will be loaded but not displayed on 
the screen. 

AUTO I^BASSC ( 

This is the proper combination of the extended "I" and 
-■#■ AUTO functions. 



BOOT Resets the computer. 

This command will cause a hardware and software reset. 

BREAK Disables/enables the break key. 

■*■ BREAK switch<ENTER> " , 

"BUILD t = Cr e a tes a "BO* f il e. -V: . • : i 
BUILD filespec<ENTER> 



■■*. *.■■*.. < 



^™J\T"? «" s reate ° f Vt d t0 * fi ' e f ° r " D ° n """'on. The maximum 
.Input line is 63 characters. This creates a file to store keystrokes for a 
specified series of commands and/or program responses. 

>To. terminate a current "BUILD" an d close the file, press the -BREAK- key. 

IMULTIDOS has 3 special -BUILD" characters which are recognized only if it I, 
the first character in a "BUILD" line. (#, $, %) 

The ^"character is used to pause execution of a -DO" file. If a message is 
desired, type it In Immediately after the "#• character. message is 

EXAMPLES: 
#<ENTEK> Pauses "DO" and waits until a -SHIFT- key is pressed. 

.^cclV™* * 77<ENTER> = P *««> -DO"after displaying message 
'INSERT DISK #77'. 8 
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LIBRARY COMMANDS 

The ■$" character is used to supress video output during "DO" without a 
•pause'. If text follows the ■$■ character It will pause the "DO" file after 
being displayed. 

The video display is turned on whenever the current "DO" file is completed 
regardless if it is a nested "DO" within a "DO" which turned off the video 
display. 

The ■%" character is used to display text only. It is used to display multi-line 
messages, which are entered one line at a time. If no text follows the "%", 
DOS will try to execute ■%". Since # Is not a valid DOS command the 
"UNKNOWN" message will be displayed and the "DO" file continued. 

NOTE: "BUILD" and "DO" automatically insert the extension "IDO" if none is 
specified. 



CLEAR Zeroes RAM. 

CLEAR<ENTER> 

CLEAR zeroes RAM from 5200 to TOPMEM. The limit of free memory, called 
■TOPMEM", is the address pointed to by the contents of 4049H & 404AH. 

EXAMPLE: 

(1) CLEAR<ENTER> 

If the contents of 4049H & 404AH are FFH and 
FDH respectively, the above command will cause all 
bytes from 5200H through FDFFH to be set to 00. 



CLOCK Displays the real time clock. 

CLOCK switch<ENTER> 

The ON mode forces the real-time clock to be displayed at the top right of 
the video display. 

As long as interrupts are enabled, the clock will be updated for each second, 
minute, and hour. After 23:59:59 the clock will be reset to 00:00:00 and the 
date will not be incremented. Also note that certain functions such as disk 
I/O and certain programs such as SCRIPSIT cause the interrupts to be turned 
off. This affects the accuracy of the clock. 

EXAMPLES: 

(1) CLOCK (OFF)<ENTER> 

The display of the clock will be discontinued. 

(2) CLOCK (ON)<ENTER> 

The clock will be displayed. 



?> > i.JV-- « -■"■- '" ■•*" ■ ■* •-- '* ' , . ""'- ^--. . '-: y **'■•''- ■-' '■■'V*-">JT-^- J gr—'^'- "•••■- ■- -'>-'-■ :*---«.<r .« ■-. .- , ■^■^^.■a.-^ — >u 



LIBRARY COMMANDS 

C MF!G Default power-up drive attributes. 

CONFIG[ (param[,param])J<ENTER> ^ 

param ' meaning 

dm drlvespec 

STEP=nn nn is drn track to track access speed 

DENSITY=q q is the default density for drn upon power-up. 

Sets Individual drive stepping speeds and initial density. 

EXAMPLE: 

CONFIG :2(STEP=6,DENSITY=P)<ENTER> 

Wilt write this Info oni© drive zero diskette (system disk), and set RAM 
configuration, for drive 2, on subsequent reboots/power-ups. 

Syntax is forgiving, only the first letter is considered. 
i.e. CONFIG 2(S=6,D=P) is equivalent to the above example. 

The stepping speeds are the track to track access speeds. The optional speeds 
available are 6, 12, 20, and 40mS. NOTE: The 6mS speed is only attainable 
with a double density hardware modification. The density's available are: S = 
single density, P = DBLDOS (tm) density, and D = double density. 

CONFIG<ENTER> echo's system disk's configuration. 

CONFIG (7)<ENTER> echo's RAM's current configuration. 

CONFIG (X)<ENTER> writes RAM's configuration onto system diskette. 



DATE Sets date. 

DATE mm/dd/yy<ENTER> 
... _DATE<ENTER> 

This command allows you to set the date. If you use the form DATE<ENTER>, 
MULTIDOS will display the date currently stored in RAM. The date is set to 
00/00/00 at power-on. However, at a non-powerup reboot, the system will 
retain the date previously set in RAM. 



DEAD . Software power on. 

All memory from 4000H upward will be set to 00, 
and the system will reset. 
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DEBUG Real time debugger. 

DEBUG[ switch) <ENTER> 

DEBUG is a real-time debugging package for use with machine language 
programs. DEBUG lets you examine and alter the contents of RAM and the 
Z-80 reglstersjump to a specified address and begin execution with optional 
breakpoints, single step or perform CALL'S, etc. 

AH values are required to be in hexadecimal form without the "H« suffix. 

Once the debugging facility is enabled, it does not load and execute until one 
of the following conditions occurs: 

1. If the interrupts are enabled and the <SHIFT><BREAK> keys are 
pressed simultaneously. 

2. After an executable program is loaded and before its first 
instruction is executed. 

NOTE: Since DEBUG loads into the overlay are of RAM (4D00H to 51FFH), you 
cannot use it with DOSO, DOS1, DOS2, DOS3, DOS4, DOS7, BASIC/CMD, 
BACKUP/CMD..FORMAT/CMD, nor RS/CMD. 

To:_return to the point where you entered DEBUG (provided you have not 
aimed the contents of the PC register), type G<ENTER>. 

To" begin execution at the address in the PC register type G<ENTER>. 

DEBUG offers two display formats: 

(1) Register display with indirect RAM plus any 64-byte ■page" of RAM. 

(2) Full screen, 256-byte "page" of RAM. 

In the register display format, DEBUG displays all the Z-80 registers, 
organized for Interpretation either as two 8-bit registers or as 16-bit 
register pairs. Since most programs use several sets of register pairs as 
indirect pointers or Indexing registers, 16 bytes of indirect data are 
presented with each register pair. Each of the flag registers is shown with 
an ASCII representation of Its flag bits. For these registers, the hex contents 
of the flag register is displayed, along with a bit-by-bit alphabetic code 
which makes it easier to interpret the flag status. For example, bit 
(rightmost bit) is the carry flag, so the alphabetic code shows an C in that 
position whenever this bit is "set". 
Table of codes for all the flag bits: 



Bi t status 
7 Sign 
- 6 Zero 
5 Unused 
4 Ha I f-carry 
3 Unused 

2 Parity/overflow 
1 Add/Subtract 
Carry 



If set 
S 

Z 
ipace 

H 
space 

P 

N 

C 
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LIBRARY COMMANDS 



DEBUG Commands 



- 


Entry 


Command 


Required 


C 


none 



Dqqqq 



<SPACE> 



none 



GfjJJi[ ( kkkk]]<ENTER> 



MfccccJ 



none 
<SPACE> 



Commands are executed as soon as you press the specified command key or 
are executed only when you press <SPACE> or <ENTER>, as Indicated belovy. 



Operation Performed 

Single-steps next instruction, with CALLS 
executed in ful I. 

Sets memory display starting address to qqqq 
in register display mode. In full screen mode, 
sets starting address to qqOO so qqqq Is 
contained in display. 

Produces continuous S C S commands <: 
unti I a key i s pressed. 

Place JJjJ in PC register and executes 
with optional breakpoint at kkkk. 

Single-steps next instruction. 

Sets the current modi ficat Ion- address to cccc. 
Modification I nformat I on wl I I be displayed in 
the lower left of the screen. If cccc is 
omitted, the last modification address will be 
used for cccc. If cccc is currently in the* 
display, It will be overlayed by a 
transparent cusor. (see next page). 

Provides continuous "I" commands 
unti I a key i s pressed. 

Loads register pair rp with the value aaaa. 
Sets display to full screen memory mode. 

Dynamic display update mode. Lets you observe 
the execution of a foreground task. 
Press <SPACE> to exit this mode. 

Sets display to register mode. 

Decrements memory display by one page. 

Increments memory display by one page. 



N - 

Rrp aaaa 

S 

U '■ 

X •:: . . ; 
up arrow 
down arrow 



none 



<SPACE> 



none 



none 



none 



none 



none 



NOTE: If you make an error while typing an address, just type the correct 
address immediately after the incorrect address. DEBUG will only look at the 
last four digits entered. 
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EXAMPLE: 

DFAE944<SPACE> 

Will dispjay the page of memory containing address E944. 

The - M" command detail 

Any time you wish to alter the contents of a memory location, type Maaaa 
then <SPACE>. This sets the memory modification address to aaaa and puts a 
memory modification prompt In the lower left corner of the display. To 
modify the contents of aaaa, type the new, two-digit contents and press 
<SPACE>. The display will then be updated, and DEBUG will increment the 
modification address by one. 

To Increment the modification address and leave the current address 
unchanged, type <SPACE> or <COMMA>. To decrement the modification address 
and leave the current address unchanged, press the back-arrow. Pressing any 
non-hex key will exit the modify memory mode. 

To disable DEBUG, type: 

DEBUG switch<ENTER> switch = (N), or (NO), or (OFF) 



DEVICE Current I/O devices. 

This command lists: KI=keyboard, DO=video display, PR=line printer, and their 
routine entry points. These are the defined I/O devices. 



DIR A specified diskette directory. 

DIR[ [:]d[(opt(,opt...J)l<ENTER> 

opt = A, I, K, P, or S 

This command in MULTIDOS displays the file directory for a single drive, 
Including the drive number, diskette title, diskette date the number of 
tracks/"lumps", number of free granules remaining, the K byte granule 
equivalent, and names of all visible and non-system files on the diskette in 
alphabetical order. The "P* option will direct the output to the printer as 
well as the display. If the printer is not ready the system will direct the 
output to the video display only. The "K" option will display "KILLED" files 
provided the directory entry location was not overwritten. The "I" option will 
display the files with the ■I" attribute as well as visible files. The «S n option 
wJII display the system files as well as visible files. You may enter as many 
options as you wish. Use of the "A" option will cause the directory display 
for each file to be expanded to Include the level of password protection, the 
date of the last update to the file, the starting track and sector, end of file 
sector and byte within the file, number of segments, the logical record 
length, and size In granules for each file. The protection level will not be 
indicated for files with the update password blank. Protection levels are 
designated as follows: 
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LIBRARY COMV.ANDS 



7 = NO ACCESS 
6 = EXECUTE 
5 = READ 
4 = WRITE 



3 
2 
1 




= (unasilgned) 
* RENAME 
■ KILL 

= (unassigned) = FULL 



EXAMPLE: 



DIR 3(A,P)<ENTER> 

The following type of output will BO tft h „,u ... 
display and the printer: h th ° 

Drive 0. Mu.tldos -09/01/81, 40/40 track, *, 

Filename Dat ' "' " tracks, 31 grans, 38.75 K 

• « f d€C CLOT 



EA/CMD 

GR/CMD 

RS/CMO 

SPOOL/CMD 

VFU/CMO 



Seg Lrl Grans 



P=6 09/01/81 04,5 

r « uj|Ui/ei 23 J 

P=6 09/01/81 24,'o 

P=6 09/01/81 23,0 

P=6 09/01/81 22,0 



34/184 
0/244 
4/252 
4/254 
9/250 



1 
1 
1 
1 
1 



256 
256 
~256 
256 
256 



7 

1 

1 

1 

2 



A maximum of twelve lines of files will h* ax , 

the next file, <SPACE>, to display a ™! f^'^ ". •»• time. To display 

<ENTER>. d,$PUy * m **'™»n of twelve additional file,. 



DO 



You 



Substitute disk file for keyboard input. 
DO filespec<ENTER> 



can nest DO»s until vou n. n „..♦ * - 

before you run oirt of m ' eni o ry . ' ° f mem ° ry - Pr ° bab| V V<>u would crash 

This command executes filesDec whlrh : 

The Extension -./I90? will,-!. ,J, nd J" Pr ?.; ,OUS, y cre »ed with "BUILD". 

f" tered. appended to f.lespec if no extension was 



DUMP 



Transfer RAM contents to disk fife. ■'■''. 

DUMP fi, e , pec ( sTART=X.ssssVEND=X.eeee4,TRA=X.tttt.J,<ENTER 
" '■"" " e 4 "»I»t hexadecimal adiie'se, 

DUMP will transfer the contents of me 



- .» specified in „,.„.'£ ^^'"^^ ^T^l 



eeee to disk. The dump C( 
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ssss must be equal to or higher than 3000H. 

eeee must be greater than ssss. 

t 
tttt is optional. If entered, it specifies the entry point for execution ofthe 

file. If no entry point Is specified the system will default to 402DH, 

MULTIDOS command mode. 

If filespec already exists It will be replaced by the contents of the specified 
area in RAM. 

EXAMPLES: 

(1) DUMP V (START=X'4000',END=X , 4400 , )<ENTER> 

The contents of memory locations 4000H through 4400H will be 
transfered to a disk file named V/CIM. 

(2) DUMP D/CMD (START=X'FDOO>,END=X'FFFF',TRA=X'FEOO')<ENTER> 

The contents of memory !acatlons FDOOH through FFFFH will be 
transferred to a disk file named D/CMD. If MULTIDOS attempts to 
execute this file it will start execution at FEOOH. 



FORMS Sets printout parameters. 

FORMS( (P*ram][,param1 ] [ ,param2 ) ]<EWER> ' 

Whereas param: 

I Intializes line counter and character counter to zero. 
W=XXX XXX=1 to 255 which is the maximum width of print line In 

characters, 255 Inhibits »FORMS' character counter. 
P=XXX XXX=1 to 255 which Is the page length in print lines. 
T=XXX XXX=1 to 255 which is the printed TEXT in print lines. 
S=XXX XXX=1 to 127 which is the blank spaces between printed TEXT. 

Only 2 of P,T, & S are required for setup. Priority Is P, T, then S. 

EXAMPLE: 

FORMS (l,W=80,T=60,P=66) 

1. The line and character counters are set to zero. 

2. The print width is 80 characters. 

3. The printed text length is 60 lines. 
4.-The page length is 66 lines. 

NOTE: If "P" and "T" are the same, pagenatlon is inhibited. 

Powers up with T=66 and P=66 (no pagenatlon) 

FORMS<ENTER> 

Will display the current FORMS parameters. 
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FREE Displays the number of available file spaces, granules 

and K byte granule equivalent of disk space on all mounted 
diskettes. 

FREE<ENTER> 

This command displays the drive number, the diskette's name and date, the 
number of available files remaining, and the number of free granules and the 
equivalent K bytes (1024 bytes) on each mounted diskette. 



HASH Returns HASH code of filespec. 

HASH BASIC/CMD<ENTER> 

Returns: 

i. 

Hash code = FO 

KEYBRD Sets keyboard attributes. 

1. LOWER CASE KEYBRD (L=Y) or (L=N) 

2. GRAPHICS DRIVER KEYBRD (G=Y) or (G=N) 

3. REPEATING KEYBOARD KEYBRO (R=Y) or (R=N) 

4. "CLEAR" Key KEYBRD (C=Y) or (C=N) 

5. BLINKING CURSOR on KEYBRD (B=Y) or (B=N) 

6. CURSOR CHARACTER KEYBRD (W=nnn) where nnn=dec imal . 

Syntax is forgiving - only the first letter is considered. KEYBRD (LOWER=YEP) 
will flag DOS to check for extra RAM chip and route drivers to display lower 
case if found. 

KEYBRD<ENTER> echo's system disks current attributes. 

EXAMPLE: 

KEYBRD (L=Y,C=N,R=Y,W=176) 

On future reboots/power-ups: 

1. The lower case driver is activated. 

2. The clear key is defeated. 

3. The repeating keyboard is on. 

4. The cursor character is 176 decimal. 

The graphics driver and blinking cursor remain as configured prior to this 
command. 
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LIBRARY COMMANDS 

KILL Delete a filespec. 

KILL filespec<ENTER> 

This command will reset the directory in use bits and deallocate diskette 
space previously allocated to this filespec. The diskette which contains the 
filespec must not have it's write protect notch covered. If a drivespec is not 
Included in the filespec, the system will search for the first drive containing 
the filespec and delete It. 



LIB Displays the MULTIDOS operating system library commands. 

LIB<ENTER> 

The library commands load between hexadecimal 5200H and 68FFH except 
•BOOT', 'BREAK', 'CLOCK', 'DEBUG', 'LIB', and 'VERIFY', which are contained in 
DOS1/SYS. (4D00H to 51FFH) 



LINK Simultaneous output of printer and display. 

The four possible Inputs are: 

LINK PRDO<ENTER> 
LINK DOPR<ENTER> 
LINK PRPR<ENTER> 
LINK DODO<ENTER> 

LINK PRDO will send to the printer whatever goes to the display. 
LINK DOPR will send to the display whatever goes to the printer. 

To un-LINK either, enter: LINK DODO or LINK PRPR 



LIST Display diskette file. 

LIST filespec<ENTER> 

This command lists a file on the display. If the file contains control codes, 
the display is suppressed. The <BREAK> key will stop the listing of a file. 



LIBRARY COMMANDS 

LOAD Place an object file from diskette Into RAM. 

LOAD file$pec<ENTER> 

This command loads the specified fiiespec into RAM and returns control to 
MULTIDOS. With MULTIDOS, you can load down to memory location 5200H and 
retain the operating system. However, if your program loads below 69Q0H, 
you cannot use some MULTIDOS library command without overlaying your 
program. 
(Permitted are 'BREAK', 'CLOCK', 'DEBUG', 'LIB', £ 'VERIFY'.) 

PRINT Printout a file onto the printer. 

PRINT filespec<ENTER> 

This command will print out the fiiespec onto the line printer. 
NOTE: If the file to be printed is not saved in ASCII format, your printout 
and printer behavior is unpredictable, a< many of the characters may be 
interpreted as linefseds, tabs, form feeds, etc. 



PROT 

PROT( [:]d] (param[,param. ,.])<ENTER> 

par am meaning 

LOCK assign MASTER PASSWORD to all user files 

UNLOCK remove all passwords from user files 

PW change the MASTER PASSWORD 

This command will change the diskette MASTER PASSWORD or lock or unlock 
all visible and non-system files on the diskette. If drivespec is not included, 
drive will be used The drivespec referenced must not have it's write 
protect notch covered. 

EXAMPLE: 

PROT (LOCK)<ENTER> 

This will assign the MASTER PASSWORD to all user files 
( non-system and visible files ). 



RENAME Change filename. 

RENAME fllespecl to filespec2<ENTER> 

This command will change the name of fllespecl to filespec2. 
filespec2 will contain the protection level, password, and directory attributes 
of filespecl. An error message will appear if the name of filespec2 already 
exists on the diskette. filespec2 should not have a drivespec specified. 






LIBRARY COMMANDS 
ROUTE Redirects printer to display or display to printer.. 

EXAMPLE: 

ROUTE PRDO<ENTER> 

Will send to the display anything directed to the printer. 

ROUTE DOPR<ENTER> 

Will send to the printer anything directed to the display. 

To UN-ROUTE you MUST specify the correct device. After 
ROUTE PRDO only ROUTE PRPR is acceptable. 

TIME Sets time. 

(1) TIME hh:mm:ss<ENTER> 

(2) TIME<ENTER> 

If version (2) is used, MULTIDOS will display, on a one time basis, the time 
currently stored in RAM. A non-powerup REBOOT will retain the time 
previously set in RAM. The hexadecimal locations 4041H - 4043H store the 
current time, in ss, mm, hh. 



TOPMEM Sets upper MULTIDOS system memory. , / 

(1) TOPMEM ddddd<ENTER> 

(2) TOPMe* Hnnnn<ENTER> 

(3) TOPMEM<ENTER> 

ddddd = A decimal number from 28671 to 65535. 
nnnn = A hexadecimal number from 6FFF to FFFF.(NOTE: Precede by "H"). 

The above command sets the upper limit of user free memory available to the 
operating system. It is useful If you have some high memory drivers which 
you want to protect. MULTIDOS programs, such as SUPERBASIC, EA/CMD, and 
others check the value of TOPMEM and operate at that limit. The value is 
placed in RAM at locations 4049H & 404AH. The default value is the top of 
system RAM. When version (3) is entered, MULTIDOS will display, in decimal, 
the highest usable byte currently available for MULTIDOS, MULTIDOS utilities, 
and SUPERBASIC usage. 

Note: MULTIDOS and SUPERBASIC accept and use TOPMEM. They do not use 
the top 64 bytes of system RAM. 



VERIFY Reread at written sector. 

VERIFY swltch<ENTER> 

This command will cause all disk writes to be reread for parity. 
All directory writes and logical writes are verified. 



SYSTEM UTILITIES 

BACKUP/CMD Duplicate a diskette. 

This utility will duplicate all files from one diskette to another requiring the 
use of one or more drives. The source diskette is the diskette which contains 
the files, and the destination diskette is the diskette which the files are to 
be duplicated on. The source diskette drive and destination diskette drive 
may be the same drive number. If the source and destination drive are the 
same, BACKUP will prompt you when to mount the source or destination 
diskette (swapping). To prevent re-writing on the source diskette when 
swapping Is required, it is recommended that a write protect tab by placed 
over the write protect notch of the source diskette.- 

The BACKUP utility is menu driven and will take you through the easy 
procedure to duplicate a diskette. 

BACKUP<ENTER> or CMD"BACKUP B <ENTER> from SUPERBASIC 
the screen will clear and 

•MULTIDOS Disk Duplicator Program - Version 2.0 

Q1 Which drive contains the source diskette? ' 

will appear. The program is awaiting a numerical response of 0, 1, 2, or 3 
followed by <ENTER>. Respond with the drive number which will contain the 
source diskette. If the response was 0, 1, 2, or 3 then: 

Q2 'Which drive for the destination diskette? ' 

will appear. Again the program is awaiting a numerical response of 0, 1, 2, or 

3 followed by <ENTER>. Respond with the drive number which will contain 
the destination diskette. If the response was 0, 1, 2, or 3 then: 

Q3 'Press "ENTER" when the source diskette is in drive X. 1 

will appear. Whereas X is the response to the first query (Q1). Mount the 
source diskette into drive X, if it is not already there, then <ENTER>. 
MULTIDOS will analyze the source diskette for track count and density, then 
display: 

The source diskette has YY tracks, in ZZZZZZ density. 

04 Track count for the destination diskette ( 35 to 96 )? ' 

Where as "YY" is the number of tracks on the source diskette and "ZZZZZZ" 
is- the density of the source diskette. The destination diskette will be 
formatted in "ZZZZZZ" density; however, you may specify the track count for 
the destination diskette. If a null, just "ENTER", is pressed for the track 
count, BACKUP will use "YY" for the track count. 
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If the entered track count is Insufficient to copy all files, BACKUP will 
display: 

•Insufficient track number to copy all filesl' 

then revert to the third- query (Q3). 

If the track count response is acceptable, BACKUP will display: 

'Press "ENTER" when the destination diskette is in drive W.' 

whereas "W" is the response to the second query (Q2). If the destination 
drive is the same as the source drive, you MUST swap the diskettes. If the 
destination diskette was previously formated then: 

■Diskette previously formatted. 

Q5 Do you want to re-format this diskette? ' 

will appear. If you want to abort BACKUP, <BREAK>, If you want to re-format 
this diskette, enter "Y a , if you want BACKUP without formatting, <ENTER>. 

BACKUP does not check the destination diskette for a density match with the 
source diskette. If the destination diskette had been formatted with a 
different density, you MUST respond "Y" to the fifth query (Q5). 

The destination diskette will be formatted if no address marks are found or a 
"Y" response was entered for the fifth query (Q5). The formatting will 
proceed then BACKUP will verify the destination diskette. BACKUP does not 
allow any flaws on a destination diskette. 

If the source drive and destination drive are the same, BACKUP will ask you 

to insert the source diskette and destination diskettes as required. The 

swapping will continue as necessary until all the files are copied onto the 
destination diskette. 

After BACKUP has copied all files 

'Completed 
Press "ENTER" when a MULTIDOS system diskette is In drive 0' 

will be displayed, prompting you to insert a MULTIDOS diskette to return to 
the state prior to entering BACKUP. 

BACKUP will duplicate the following diskettes 

1. TRSDOS 6. DOSPLUS, MOD I I I 11. MULTIDOS, S-DEN 

2. NEWDOS, NEMXDS+ 7. DBLDOS 12. MULTIDOS, P-OEN 

3. ULTRADOS 8. LDOS 13. MULTIDOS, D-DEN 

4. DOSPLUS, single density 9. LDOS, double density 14. See below 
5< DOSPLUS, double density 10. LDOS, MOD ill IS. See below 
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For 14 and 15, BACKUP will duplicate a NEWDOS 80 version 1.0 diskette, with 
a 2 granule directory, (the NEWDOS 80 version 2.0 author decided to ignore 
the lock out table, WRONG!; therefore , BACKUP cannot duplicate these 
diskettes. However, MULTIDOS will READ any files from these diskettes, 
provided th'e directory is only 2 grans). 

It actually takes very few keystrokes to backup a diskette. For example, to 
duplicate a diskette In drive zero to drive 1, would require the following 
keystrokes: (after BACKUP Is entered) 

0<ENTER>, 1<ENTER>, <ENTER> 



COPY/CMD Duplicate a single file. 

This utility will copy a file from one diskette~to another. The diskette which 
contains the file will be referred to as the source diskette. The diskette in 
which the file will be placed on will be referred to as the destination 
diskette. The source and destination diskettes may be: 

1. The same diskette. 

2. Diskettes to be mounted in the same drive, 
or 3. Diskettes in two different drives. 

This utility requires ALL drlvespecs. If the fiiespec for the destination 
diskette, is the same as the fiiespec for the source diskette then the fiiespec 
need not be repeated. 

(1) COPY CHARGES/TXT:1 TO :2<ENTER> 

If the destination diskette's drlvespec is the same as the source diskette's 
cjrjve spec, you will be prompted to mount the source or destination diskette 
(swapping). 

" * (2)' COPY :3 SHIFT/TXT TO MURK/ABC<ENTER> 

(3) COPY SHIFT/TXT:3 TO MURK/ABC:3<ENTER> 

$oth of : the above two command entries wlfl duplicate the contents of 
SHIFT/TXT Into MURK/ABC on drive number three. 

System diskettes are MULTIDOS system diskettes with at least, DOSO, DOS1, 
DOS2, DOS3, and DOS4. Alien diskettes are diskettes with a system other than 
MULTIDOS. Data diskettes are diskettes without a system. 

Whenever drive zero is specified and the source or destination diskette is not 
a system diskette, a ■$* MUST precede the source fiiespec. 

(4) COPY $WHENEVER/BAS:0 TO :2 

? (5) COPY :0 $HELPME/CIM TO SHOWME/CIM 

(6) COPY $ THEM/OLD:0 TO THEM/NEW:! 

(7) COPY $ MANUAL/TXT:3 TO :0 
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The ■$■ designator in COPY will permit you to copy file « 

alfen/system/data diskette to any other alien/iystem/data dlsk'ei 

multiple swapping will be required to bring in the correct syste. 

Please follow the prompting provided by COPY. Whenever the prompt: < 

•Press -ENTER- when'a MULTIDOS system diskette is in drive 0.' 

appears, remove the source or destination diskette and Insert your MULTIDO 
system diskette, then press -ENTER-* 

« 
COPY will carry over the source filespee's date. However, If you want the i 



destination fllespec to have the current RAM date, place a -#- immediately in 
front of the source filespec. 



i 



(8) COPY #CHECKING/BAS:1 TO CHECKING/BAS2 

(9) COPY #CHECKING/BAS:0 TO :0 $ 
(1 0\ COPY •"> £C WFrifiMn/Q ac ■* 

(11) COPY :2 #CHECKING/BAS TO CHECK1NG/BAS "~~" ' 

(12) COPY :0 $ #CHECKING/BAS ' " t 

TECHNICAL NOTES 

COPY will execute in the following sequence. 

% 

1. Check for "$". j 

2. Check for "#". 

3. Position the source filespec in COPY's DCB-1 / . $ 

4. Insert source drivespec into DCB-1 then check for validity. 

5. Position the destination filespec in COPY'S DCB-2. 

6. Insert destination drivespec into DCB-2 then check for validity. *& 

7. Check for swap. 

8. OPEN source filespec. 

9. Stores source filespec sector allocation. % 
10. READ in as m»:h ot source filespec into available RAM. 

^ t;;ir p £ia°E" the destinatlon f,,e$pec ' if found »"•• — . * 

13. Calculates and stores the amount of free sectors on the destination 

drive, (converts granules) & 

14. If the destination filespec existed, adds and stores the total 
number of sectors available. 

15. Compares the total sectors available on the destination drive with • 

the- source filespee's sector allocation. 

16. Abort COPY if insufficient space is on destination diskette. - ^ 
'/. If the destination filespec didn't exist INIT the destination • 

filespec. 
18. Check foe "SYSTEM" swap. 

• l9 ' dis°k C eVte. a " ieCt0fS {VU granU ' e a,,ocation > onthe destination 9 

20. WRITE out to the destination filespec as much of the source 4ft 
filespec read into RAM in step 10. " 

21. Check for swap if all of source filespec was read into RAM and 

written out to the destination filespec. 

Page 26 ® 



SYSTEM UTILITIES 

22. Check for -SYSTEM" swap. 

23. Check for swap. 

24. Close destination fllespec. 

25. Check for "SYSTEM" SWAP. 

26. Display error If any. 

27. Return to MULTIDOS or SUPERBASIC. 

If in error occurs during steps 4 6 8 in i« *-» -« 

lump to step 25. P ' *' 8 ' T0 » * 6 ' 1 7 » 2 °» or 24, then COPY will 

tha r t COPY ,° $erS Wh ° haVC Cperated °^er COPY utilities „i 

that COPY assumes ail nonconfllctlne drlw.cX wi . ut,,,Ues » P ,ease appreciate 

executing file duplication. * drlve$ P ec diskettes are mounted prior to 

EXAMPLE: 

(13) COPY FUNLOVER/TXT:2 TO :3 

Does NOT prompt the user to mount any diskettes. 
FORMAT/CMD Prepare a -hk . |u ,„ ^ ^^ 

^"w." M <™ operating system, 

referred to as "DATA" diskette,. ' V ° Ur f,,es * Thesc diskettes are 

FORMAT<ENTER> or CMD"FORMAT"<ENTER> from SUPERBASIC 
Operation is as follows: 

'MULTIDOS Formatter Program - Version X.X 

(1) "hlch drive contains the diskette to be formatted? . 
Reply with 0,1,2, or 3." 

(2) 'Single, Double, or "P" density ( S,D, or P )? i 

Reply with S, D, or P. 

WIN default to current < v .i. n _ *, 

query """" '*""" "Ration. If -D- is specified then the 

(3) 'Density for track zero ( S or D )? » 
will be displayed. (Defaults to ,i ng , e density) 
(4)' Track count for this diskette ( 2 TO 96 )? « 
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Reply with the desired track count. The program car. only FORMAT up to the 
drive capacity. If you only have a 35 track drive, you cannot format 40 
tracks. If you do not enter a track count, MULTIDOS will default to 40 
tracks. 

(5) 'Whictl track for* the directory ( 1 to XX )? « 

XX = The reply to question # 4 less one. 
The system will default to track 17 decimal (11 hex) 

(6) 'Name of diskette to be formatted?' 

Reply with the desired diskette name (DATA1, BASICPRO, etc.). The name may 
be 1-8 characters in length. The system will default to ■* DATA •". 

(7) 'Date for the diskette to be formatted?' 

Reply with a date In the format mm/dd/yy. Defaults to RAM date. 

(8) The master password for this diskette? » 

Reply with the password desired for this diskette. The password may be 1-8 
characters in length. Defaults to "PASSWORD". 

If the diskette to be formatted contains data, MULTIDOS will suspend 
formatting. Only a "Y" response will cause formatting to continue. 

Formatting will proceed. You will be kept advised of the progress via .screen 
messages. MULTIDOS will lock out granules (If the diskette has flaws) and 
bump the verifying counters to the next granule. 
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-JA/CMD Editor Assembler. 

This utility is Radio Shack's tape version which had been modified by App'arat 
Inc. for disk I/O. Further enhancements to this program were implemented 
starting January 1980. Since this program is not a MULTIDOS ■original", 
complete documentation will not by supplied. It is required that the user 
purchase Radio Shack's tape (not disk) Editor Assembler for complete 
documentation. 

The utility is initialized by typing EA<ENTER> from the MULTIDOS command 
mode or CMD"EA" from SUPERBASIC 



The first prompt will be 'Protect memory from (dec)?' At this point the user 
should: 

1. Press "ENTER" if no other machine language program is in high 
memory or a machine language program is in high memory with 
"TOPMEM" properly set. 

2. Press "BREAK" to recover previous source code. This can be 

accomplished after an inadvertent reboot or exit from the 
utility. This function will use the previous "TOPMEM". 

3. Enter the lowest decimal number in which a machine .language 

program occupies in high memory. 

NOTE: DO NOT ENTER A NUMBER IF EA/CMD IS ENTERED FROM SUPERBASIC. 
Any machine language program in high memory prior to entering 
SUPERBASIC must have its memory protected when entering SUPERBASIC. 



There are three additional commands with this version. 

1. C copy filespecs 

•C filespec to fllespec<ENTER> 
Both filespecs are required and drive specs are recommended. 

2. K kill filespec 

•K filespec<ENTER> 

3. V View directory 

•V drn<ENTER> 
dm = 0, 1 f 2, 3 without a colon (:). 

If dm is not specified, will be used. Due to RAM limitations, 
the directory will scroll if mor-e than 60 files are on a 
diskette. 



UTILITIES 
GR/CMD 

This MULTIDOS utility allows direct keyboard entry of graphics characters. 
Enter the command' "GR" from the DOS ready mode, do NOT enter from 
SUPERBASICJ To shift to graphics mode, press the <SHIFT> key md the 
<CLEAR> key at the same time. Graphics characters are now available as 
shown in table 4-1. These characters may be directly entered Into strings In 
BASIC. 



Qraphicn 
<pixsls lit) 

- ■ 1 - ■ 2 - « 3-. 4-| 3-.- & - P 

7 " ■ 8 <■ ^ 9 » I A - "| B - « C-fc D«J 
E-B F- b S-. H - / I - - J - , K-| 

L - f M - f» N-ji O-J P"^ Q-y R-p 

8 m jj, T - gS U ■ p V- W - ■ X - ■ Y 
2 ■■ ^ up-arrow " I 

low«rc*M (or SHIFTED without lowawcame keyboard) 

•-< b - £ C - J d - ^ . - | f . -| g „ ^ 

h "% * - <f J-q k m m 1"L ■ - J| n-; 

°"L P-L. * " £ r-| .-j t-J u-J 

v "3 » m m * " I v-i * - | 



a 



Table 4-1 
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RS/CMD RAM Scanner. 

This utility- will scan the memory from OOOOH to FFFFH and attempt to locate 
an 8 bit byte or 16 bit word specified by the user. The utility will ask: 

'START?' 
Enter the starting address, in hex, at this time. Next the utility will ask: 

•STOP?' 
Enter the ending address, In hex. Next the utility will ask: 

•BYTE, OR WORD SEARCH (B/W)?' 

For a one byte, search enter "B". For a two byte search, enter "W". Next the 
utility will ask you to enter the search target. Enter the target at this time. 
The input must consist of two or four hexadecimal characters, without the 
■H" suffix, and must not con'iin any blanks. Acceptable words would be 
«00AB n , "DE09", etc. Acceptable bytes would be "74", "09", etc. 

Next, for word scans only, the utility will ask: 

•Enter auxiliary mnemonic ' 

You can optionally inquire about calls, jumps, and loads to a selected word at 
this time. 

Enter one or more of the following characters and the <ENTER> character: 

C = CALL/CARRY 

J = JUMP 

L = LOAD 

M * SIGN MINUS 

N ■ NON 

P = SIGN POSITIVE 
PE = PARITY EVEN 
PO » PARITY ODD 

2 = ZERO 

The above terms may be combined if needed. If no auxiliary mnemonic is 
desired press <ENTER>. For the "L" (LOAD) command, the following question 
will be asked: 

•IMMEDIATE *l», I OR DIRECT ■D"?' 

If the response Is "D", the utility will ask: 

•■F" FROM or "T" TO the register?' 
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Answer as desired. Finally the utility will ask: 

•Accumulator, A or register pair - BC, DE, HL, SP, IX, IY :■ 

Enter the desired register pair. 

The utility will then display the hexadecimal locations where the specified 
byte or word is found. 

EXAMPLES: let START ■ 0000, STOP ■ 2FFF (ROM) 

(1) Enter search word 3C00<ENTER> 

Enter auxiliary mnemonic <ENTER> 

04C1 0555 06F2 2080 

Function completed - Press "R* to scan again, 

'CLEAR* to r@tur?!e 

The word 3C00 was referenced In ro'm at locations 
04C1H, 0555H, 06F2H, and 2080H. 

(2) Enter search word 4000<ENTER> 

Enter auxiliary mnemonic J<ENTER> 

0005 0008 

Function complated - Press "R" to scan again, 

■CLEAR" to return. 

The "JP 4000H" command is found at locations 
0005H and 0008H In ROM. 



SPOOL/CMD 

This MULTIDOS utility is designed to allow the computer to function at almost 
full speed without delays for the printer to function. The utility provides a 
variable RAM buffer for parallel printers and provides more effective 
utilization of the printer control codes. 

SPOOL<ENTER> 

The following questions will appear. Respond as indicated. 

(1) 'How many 256 byte blocks for spooling (1-99)? * 

This lets you set the buffer size for .the spooler. The size is 
selected in 1/4 K increments. As an example, to reserve a 2K 
buffer the reply to the above question would be 8<ENTER>. 

(2) 'PAGENATE (Y/N)T « 

Reply "N" if you do not want automatic paging or if your program 
pokes the line printed device control block to simulate paging. 
Reply "Y" if you want the spooler to control paging. 
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(3) 'Print lines per page (1-99)7 ' 

If you replied "Y" to' question 2, you will be asked to select the 
number of printed lines per page. This Is not the total number of 
available lines per page, only the number of printed lines. 

(4) 'Blank lines per page (1-15)7 ' 

If you replied "Y" to question 2, you will be asked to select the 
number of blank lines between pages. The sum of the answers to 
questions 3 4 4 should equal the total page length. 

(5) 'Characters per line (1-255)7' 

Select the desired line length. The spooler will send a 
linefeed/carriage return after that number of characters if the 
system has not already sent one. You should not select a line 
length longer than the maximum allowed by your printer. A response 
of 255 will override this feature. 

(6) 'SPOOL (Y/N)7 ' 

Answer "Y" if you want the printed output to be sent through the 
buffer for better system response. If you answer *N", spooling 
will not take place, but SPOOL/CMD will still control the output 
page parameters. 

(7) "ENTER memory size (DECIMAL) YOU WANT TO PROTECT. ' . 

Use this to protect a high memory routine which does not protect 
Itself by setting TOPMEM (4049H). Press <ENTER> to use the value 
MULTIDOS has established in TOPMEM. <BREAK> to abort spooler. 



The spooler will now commence operation and control of any printed output. 
To suspend output, press shift <BREAK>. You will be asked if the buffer is to 
be saved and will be prompted again to enter the spooler parameters. 

The spooler will recognize CHR$(11) as a linefeed without a carriage return. 
CHR$(12) will generate a formfeed. CHR$(10) & CHR$(13), will be treated as 
linefeeds with carriage returns. 

The spooler will ignore ROM generated linefeeds/carriage returns and will 
format the printout per your program and spool parameters within the limits 
of your printer capability. 
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VFU/CMD 

This versatile file utility (VFU) provides for four frequently needed disk 
operations: multiple file copying, purging of files, printing a disk directory, 
and menu based execution of all programs on a disk. 

INITIALIZATION & EXIT 

T@ initialize the utility from MULTIDOS, use the following Instruction* 

VFU<ENTER> 

To Initialize the utility from SUPERBASIC, use the following Instruction: 

CMD n VFU"<ENTER> 

When properly initialized, the utility will clear the screen and prompt with 
the following message: 

File utility, BY V. B. Hester, - Version X.X Press 

8 £ B x C0PYf sgs - EXECUTE, B P 9 = PURGE, OR "H" = HARD COPY. 

A winking cursor will indicate that user input It required. 

To exit the utility when the winking cursor is displayed, press <CLEAR>. To 
exit the utility when the normal cursor is displayed, press <BREAK>. If you 
entered the utility from SUPERBASIC via the 'CMD"VFU"» mode, you will be 
returned to SUPERBASIC. If you entered the utility from MULTIDOS, you will 
be returned to the DOS ready mode. 

VFU COPY COMMAND 

To copy files from one drive to another, use the "C" command. The utility 
will then prompt: 

Press »S» for SELECTIVE, or "T" for TOTAL. 

To copy the entire diskette, press "T». To select the files to be copied, press 
"S». Now the utility will ask if invisible and system files are to be 
considered in the copy operation with the following prompts: 

Include "INVISIBLE" files? 
Include "SYSTEM" files? 

Answer "Y" or "N" as appropriate. Finally, the utility will request the source 
and destination drives with the following prompt: 

Source drive? to destination drive? 

NOTE: the source and destination drive cannot be equal. 
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If the selective option was chosen, the directory will be displayed with the 
winking cursor next to the first file name. If that file Is to be copied, press 
"Y". A ■+" will appear In front of the file name to Indicate that It is to be 
copied and-the winking cursor will move to the next file. If you do not want 
to copy the file, pre-,s "N", space bar or right arrow. The cursor will move 
to the next file. The four arrow keys may be used to move the cursor. 

During the file selection process, the left arrow will reposition the cursor to 
the previous filename, removing the ■+■ if present. The shifted left arrow will 
reposition the cursor to the first filename, removing ail *+" present. 

If the "T" option was selected, the ■+■ sign will appear in front of all 
filenames. 

After you have decided what files are to be copied, the following prompt will 
appear: 

Press "A" TO ABORT, "ENTER" TO EXECUTE, or "R" TO REPEAT. 

Press <ENTER> to start the copying function. If you do not want to copy, 
press "A". To prematurely terminate the copying function, hold down a shift 
key. The utility will complete copying the current file and terminate before 
it starts to copy the next file. 



VFU EXECUTE COMMAND 

To execute programs from a diskette, use the "E" command, the utility will 
then prompt: 

Drive x press "Y" to execute to "N" to skip. 

Disk - MULTIDOS - 03/12/81, 6 FREE GRANS. 

Next an alphabetical directory will be displayed. Use the arrow keys to 
position the winking cursor in front of the file to be executed and press "Y n . 
If the selected fllespec has the "/CMD" extension, VFU will load and then 
execute that fllespec. If the ■/CMD" extension Is not present, VFU will load 
BASIC and then load and attempt to run the filespec. 



VFU PURGE COMMAND 

To purge files from a diskette, use the "P" command. The utility will then 
prompt: 

Press »S" FOR SELECTIVE, or "T" FOR TOTAL. 

To purge all files from the diskette, press "T". To select the files to be 
purged, press "S". Next the utility will ask if invlsibfe and system files are to 
be considered for purge action with the following prompts: 
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Include "INVISIBLE" files? 
Include "SYSTEM" files? 

Answer "Y" or "N" as appropriate. 

Finally, the utility will request the drive number with the following prompt: 

Drive number? 

If the selective option was chosen, the directory from the selected drive will 
be displayed with the winking cursor next to the first file name. If that file 
Is to be purged, press «Y". A ■>+■ will appear in front of the file name to 
indicate that It is to be purged and the winking cursor will move to the next 
file. If you do not want to purge the file, press "N", space bar or right 
arrow. The cursor will move to the next file. 

During the file selection process, the left arrow will reposition the cursor to 
the previous filename, removing the »+■ if present. The shifted left arrow will 
reposition the cursor to the first filename, removing all »+■ present. 

1/ the "T" option was selected, the "+» sign will appear in front of all 
filenames. 

After you have decided what files are to be purged, the following prompt 
will appear: H 

Press "A" TO ABORT, "ENTER" TO EXECUTE, or "R" TO REPEAT. 

Press <ENTER> to start the purge function. If you do not want to purge 
press A". To prematurely terminate the purge function, hold down a shift' 
key. The utility will complete purging the current file and terminate without 
purging any additional files. 

After the purge process is completed, the revised directory of the diskette 
will be displayed. 



VFU PRINT DIRECTORY COMMAND 

To print a diskette directory, use the "H" command. The utility will ask if 

L n h^L b ^ -* nd , syste ^ fi,e$ * re t0 be Included in the directory printout and 
wh ch drive is to be used. Then it will ask for the name or number of the 
diskette (8 characters maximum). The directory will be displayed on the 
screen. Finally, the utility will prompt with the following message: 

Press -A" TO ABORT, OR "ENTER" TO EXECUTE. 

A reply of <ENTER> will cause the directory to be printed. If a 10 
character/Inch printer is used, the printout will be sized to fit Inside the 
diskette jacket. 
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BASIC High level language interpreter. 

4 

SUPERBASIC (file name BASIC/CMD) is a MULTIDOS command file which 
contains the code to enhance/control the ROM, and adds disk input/output 
capabilities. 

BASIC[ ff|V]](,mm][,command]<ENTER> 
This command will load SUPERBASIC into your system, from the Multidos ready 
prompt. 

ff = An optional number of file buffers to be opened by basic (0-15). 

If you want to use RANDOM disk I/O, and a record length other than 256, 
then V must be appended to the number of file buffers. 

mm = An optional upper memory limit which can reserve space for 
machine language subroutines. 

command = Any valid BASIC command. 

NOTE: The default values are 3 files and all memory to TOPMEM available to 
SUPERBASIC. 

This version of SUPERBASIC is shorter than any other DISK BASIC, leaving 
more room for your program. 

EXAMPLES: 

(1) BASIC<ENTER> 

SUPERBASIC will be loaded with 3 file buffers open and all of 
RAM up to TOPMEM available for use. 

(2) BASIC 4<ENTER> 

SUPERBASIC will be loaded with 4 file buffers open and all of 
RAM up to TOPMEM available for use. 

(3) BASIC 2V,60000,RUN "PROG1/BAS"<ENTER> 

SUPERBASIC will be loaded with 2 file buffers open. RAM from 
60000 up will not be available to SUPERBASIC. The program 
"PROG1/BAS" will be loaded by SUPERBASIC and RUN. With the V 
appended to the number of file buffers (2V), user defined 
record lengths are permitted. However, normal sequential disk 
I/O is permitted if the V is specified or not. 

For each file buffer opened, SUPERBASIC will reserve 289 bytes. 
33 for a DCB, and 256 for the I/O buffer. If the V parameter is specified, an 
additional 256 bytes are reserved. One will be used for "FIELD"ing and the 
other for disk I/O. 
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BASIC * Recover BASIC program. 

BASIC *<ENTER> 

This command assumes SUPERBASIC was previously loaded Into your system, 
you now have the MULTIDOS prompt, and you want to return to SUPERBASIC 
with the previous program unchanged with variables intact. 

CAUTION: Because SUPERBASIC has expanded "CMD 8 functions, and makes 
additional memory space available, you cannot go from SUPERBASIC to 
MULTIDOS, execute commands such as "DIR" and then use "BASIC *" to return. 
In such cases you should use the CMD"uuuuu" function from within 
SUPERBASIC. 

jf the return to SUPERBASIC was successful a 'Continue? ' ; prompt will 
appear. Enter 'Y' If you want the program to continue (ev~en after re-boots). 

BASIC I Down load a BASIC program. 

BASIC (<ENTER> 

This unique command permits you to transfer a BASIC program which has been 
loaded via an alien operating system or SUPERBASIC, with at least 1 file 
buffer, to SUPERBASIC, without saving the program on disk. 

With a BASIC program in RAM, insert your MULTIDOS diskette into drive 0, 
hold down the enter key, and press reset. When the MULTIDOS prompt 
appears, enter "BASIC I". SUPERBASIC will be initialized with zero file 
buffers, previous TOPMEM, and the program text retained. 

BASIC # Recover a LEVEL II BASIC program. 

BASIC #<ENTER> 

This command Is used to transfer a program from LEVEL II BASIC to 
SUPERBASIC, providing proper entry to LEVEL II BASIC was first made via 
CMD"X» from SUPERBASIC. This feature will allow you to work In a LEVEL II 
environment to develop programs or to transfer a sensitive LEVEL II program 
from tape to disk. 

MULTIDOS uses SUPERBASIC'S CMD»X" function to enter LEVEL II BASIC. You 
may use CMD"X" with or without a program in RAM. If a program is in RAM, 
it will be transferred to LEVEL II BASIC with text retained. This function is 
provided in lieu of "BASIC2", since it can completely incorporate the n BASIC2 u 
function while maintaining the program in RAM. 

To exit from LEVEL II BASIC to SUPERBASIC with the program Intact, type 
"SYSTEM", answer the ■•?■ With "/I 6*80", hold down the enter key and wait 
for the MULTIDOS prompt. Enter "BASIC #" as shown above. 

SUPERBASIC will load with your program's text retained. 
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BBASIC 



Enhanced SUPERBASIC 



BBASIC has all of the features of SUPERBASIC with the addition of all of 
BOSS'S single step, trace, and variable review functions. Even with the 
Incorporation of all of these functions, BOSS-SUPERBASIC uses less RAM than 
any other disk basic. Upon entering BBASIC, a new keyboard driver is 
activated, changing the key with the "<g" symbol to a control key. The «@« 
character is printed by pressing SHIFT-SPACE-BAR. 

There are seven additional functions available with BBASIC. These functions 
are Invoked by pressing down the key with the n @" symbol first then, without 
removing your finger from this key, press one of the keys labeled 1 thru 7. 
The same functions can be obtained thru program execution by poking an 
appropriate number Into 16667 decimal or 41 IB hex. (This is - ROM's trace 
on/off byte.) With the incorporation of these new trace functions, the TRON 
and TROFF functions are disabled. 

The particular functions will be discrlbed with the n @" symbol preceding a 
number 1 thru 7. This represents pressing the "@ B key along with the 
numbered key following the *@*. 

@1 TRACE OFF 

This will turn off all trace functions. 

@2 TRACE ON - VIDEO 

This function will trace line number execution in the upper 
right hand corner of the display. The last four lines 
executed will be displayed. As a new line is en.tered, its 
number will appear prefixed by the ■#» sign. If more than 
four lines have been executed the trace will start at the 
top and overprint the previously displayed trace functions. 



TRACE ON - PRINTER 

This function will direct the trace to the printer in 



the 



format " #####", requiring 6 characters for each line. 



NOTE: The trace information will show the complete program flow, but will 
only be printed when an entire print line is available. This is because the 
printer will not output any data until a complete print line is sent. If a 
character at a time printer is being used, the trace information will be 
printed as each program line number is executed. The print format for a 
trace to printer is space, 10k digit, Ik digit, 100's digit, 10's digit, and unit 
digit. Zero suppression is used and each line requires six character positions. 
This fits in well with 72 character per line (12 line traces) and 132 
character per line (22 line traces) printers. This output can be controlled by 
any type of user linkup to the printer device control block, since it is raw 
space/numeric output. No linefeeds, carriage returns, or control characters are 
sent. 

@4 SINGLE STEP OFF 

This function will turn off all single step functions. 
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@5 SINGLE STEP TO THE END OF LINE 

This function will execute one program line then wait. 

®6 SINGLE STEP INSTRUCTION 

This function will execute one BASIC Instruction then wait. 

®7 SINGLE STEP WITH TIMED WAIT 

This function will execute one program line or Instruction 
pause for a predetermined amount of time, then continue. 

SINGLE STEPPING 

You can single step individual lines of a BASIC program or individual 
Instructions within a line. In addition, you can vary the delay in which »our 
program steps between lines or individual instructions. There 'are four "slneTe 
step commands. • B 

551 - Single step off 

Pressing »@4" win turn off the single step function and allow your program 
to run as normal. If the trace function was in use, it will continue to 
function until turned off. 

552 - Single step to end of line 

Pressing «®5* will cause your program to pause at the end of each line until 
any key is pressed. The trace to video display mode will also be initiated to 
show you which line number Is being executed. This trace mode can be 
disabled by a »@1», while the single step mode continues. 

553 - Single step instruction 

Pressing -@6" will cause your program to pause when an instruction separator 
:, is found and at the end of each line. Press any key to continue to the' 
next mstruct.on. Again, the trace to video display mode will be initialized to 
show you which line number is being executed. This function can be useful 
but be wary of using it if a program contains lines such as: 

90 FOR X = 1 TO 100:A(X)=6+3«X-Z:NEXT X 

To single step through this loop would require 300 presses of a key. Instead 
use "single step to end of line." 

554 - Variable delay step (auto step) 

Pressing «@7" will cause your program to delay approximately 0.25 seconds at 
the end of each line. Again the trace to video will be Invoked to show you 






slow down execution (increase delay) ' p r "ess"" # d "o"w "n" arrow". ThTamoun't of 

r „ ?"" be adjusted any time after BBASIC is initialized. The initial setting 
provides 0.25 seconds de.ay. The amount of delay is halved each tim! 

Oup-irrow- is pressed,, or doubled each time "Odown-arrow" i $ pressed 
Uurmg this delay, key presses are not recognized. 
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BREAK POINTS 

The trace and single step commands previously described can be invoked by 
your program while it is running by inserting a POKE instruction in your 
program at the location where you want to invoke the command. The 
following codes are used: 

FUNCTION POKE 16667, 

TRACE off 1 

TRACE to display 2 

TRACE to printer 3 

SINGLE STEP off 4 . 

SINGLE STEP line 5 

SINGLE STEP instruction 6 

SINGLE STEP delay 1 

EXAMPLES OF BREAK POINT USE 

If you want normal program execution to line 1540, then single stepping with 

trace to the screen, Insert just prior to line 1540, the instruction "POKE 

16567,5". 

EXAMPLE 1 EXAMPLE 2 

1530 (users text) 1530 (users text) 

1535 POKE 16667,5 1540 POKE 16667,5: (users text) 

1540 (users text) 

NOTE: If your program logic has GOTO's, GOSUB's, etc., be sure to position the 
break point where the code will be executed. Multiple POKE'S are permitted; 
POKE16667,7:POKE16667,6:POKE1 6667,1 
This will invoke "variable delay step" between instructions with the trace 

disabled. 

NOTE: You can insert as many break points in your program as you desire. 

REVIEWING VARIABLES 

BBASIC will suspend program execution to review selected variables and then 
return to your program with the display restored to that shown before you 
reviewed the variables. There are two commands used for this function. 

@N = select variables for review 

©O = review the selected variables 

SELECTING VARIABLES 

Pressing "@N" will allow you to select the variables you want to review 

during program execution. This command can be entered at any time before 

you run the program or during program execution. After invoking "@N", the 

query 'Enter maximum length? • will be displayed. Respond from the following 

choices: 

RESPONSE RESULT 

BREAK exit function & return to BASIC program 

1 1 character variable names 

2 or 3 maximum of 3 character variable names 
4-7 maximum of 7 character variable names 
8-15 maximum of 15 character variable names 
16 - 31 maximum of 31 character variable names 
ENTER default to maximum of 7 character names 
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The maximum number of variables for review Is limited by the maximum 

variable name length se|ected, as shown below. 

NAME LENGTH NUMBER OF VARIABLES TO REVIEW 

1 maximum of 128 

2-3 maximum of 64 

4-7 maximum of 32 

8-15 maximum of 16 

1 6-31 maximum of 8 

NOTE: The name length includes all characters. The variable name A$(21,5) is 
considered to have a length of eight (8). F(R(3,8)) is nine characters in 
length. After successfully entering a variable length, the message 'Input 
variables' will be displayed and all previously entered variable choices will be 
erased. This function wilt allow you to enter variables using the following 
syntax: 

A XI B# QI(F(G,Q)) 

KS A1(F(G,Q)) F(2,3) T# (F, (B( A.N) ,G(E) ) ) 

A(B) WEEKDAY S% A(B,C) 

Any number of parentheses are allowed, provided you close them within the 
variable length entered. Although illegal variable names such as A$3 or A(3H) 
are net rejected, they will cause errors later when review of the variables is 
attempted. When you have finished entering the variables, press "BREAK" to 
continue with the review. If you enter the maximum number of variables 
allowed, BBASIC will automatically proceed with the review. At this point 
B3ASIC invokes an "<§0" as described beiow. 

Pressing "@0" at any time during program execution will immediately save the 
contents of the video display and replace it with the message 'C n = change, 
«D" = delete, "I" = insert' will appear along with the first variable and its 
value. Variables are displayed in the order entered by the "@N" function. 
Pressing "CLEAR" will cause the message "End of variables." to appear. If you 
are really finished with the variable review, press "CLEAR" again and your 
original video display will be returned. Your program will resume execution at 
that point. If you instead want to review more variables, press any key other 
than "CLEAR". Pressing "C" will allow you to select another variable in place 
of the last variable displayed. The new variable selected and its value will 
be displayed. Remember, the variable name is limited in length per your 
original choice when "@N" was selected. Pressing "D" will delete the last 
displayed variable. Pressing "I" will insert a variable PRIOR to the last, 
displayed variable. Pressing any key other than "CLEAR", "C", "D", or "I" will 
advance the display to the next variable selected. If you attempt to review a 
variable whose subscript is out of range or with an Illegal name, the message 
•ERROR, RE-ENTER' will be displayed and the "C" command will automatically 
be invoked. You must select a valid variable to exit from this sub-command. 
If you evaluate an element of an array (subscript-- < 11) and the array has 
not yet been dimensioned by your program, this array will be dimensioned for 
eleven elements (0-10). If your program subsequently attempts to dimension 
this array via the "DIM" instruction, an error will occur. Dimension all used 
arrays before you review them with the review variables function. 
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SUPERBASIC 
SUPERBA5IC enhancements to LEVEL II BASIC. 
SHORTHANP 

Single keystroke commands: 

. (period) = list current line 

, (comma) = edit current line 

/ (slash) = list "BREAK in" line 

up-arrow = list previous line j 

down-arrow = list nest line 

shift-up-arrow = list first program line . 

shi f t-down-arrow = list last program line 

These single keystroke commands MUST be the first entry after the 
BASIC prompt, ■>", appears. 

Single letter commands: ^ 

L(.)<ENTER> = list current line 

El.]<ENTER> = edit current line 

D[.]<ENTER> = delete current line 

P<ENTER> = list page from current line 

Pn<ENTER> = list page from line "n" 

C<ENTER> = continue program e-xecution 

R<ENTER> = run program 

R"filespec" = run filespec 

SUPERBASIC allows you to use abbreviated commands. To list fhe current line, 
type ".", "L<ENTER>", or "L.<ENTER>". To edit the current line, type ",", 
»E<ENTER>", or »E.<ENTER>". To delete the current line, type "D<ENTER> n or 
"D.<ENTER>". The "-" can be used in conjunction with the "L" and "D n . To list 
everything from the first program line up to the current line, type 
■L-.<ENTER>". To list the entire program, type "L-<ENTER>". The symbol "/" 
will list the last line for which the "BREAK IN LINE ##" message was issued. 
The default line ##, if no break has occured, Is the last line of the program. 
The up arrow will display the preceding line while the down arrow will 
display the next line. The shifted up arrow will display the first program 
line. The shifted down arrow or the shifted down arrow & Z will display the 
last line. 

EXAMPLES: 

In each example the following BASIC program is in memory 
and the line pointer points to line #20. 

10 For X= 1 to 20 
20 PRINT X, X*X, X*X»X 
. 30 NEXT X 
40 END 

(1) L<ENTER> 

Line 20 will be displayed. 

(2) L-.<ENTER> 

Lines 10 and 20 will be listed. 

(3) L.-<ENTER> 

Lines 20, 30, & 40 will be listed. 
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4H and 40 Hex and octal constants. 

&{H]dddd 
jjQdddd t 

This command allows you to use hexadecimal (base 16) or octal (base 8) 
constants within your program. The »H« is optional In SUPERBASIC. 



EXAMPLE: 
X = &4000 
Y = &6000 - 45200 
POKE 4FFFC, 4 



This assigns 16384 to the variable X. 
This assigns 2584 to the variable Y. 
This puts a 4 in RAM location -3 (65533), 



CMD"^ Space compression. 

CMD n C"<ENTER> 

This command will eliminate spaces and I'nefeeds within the resident program 
in RAM, at the rate of approximately 8000 bytes per second. This command 
will not remove spaces or linefeeds which are in quoted text, data 
statements, or remark statements. This command allows you to remove 
unnecessary bytes from your program, resulting in more free memory space 
and faster program execution. 



CMO , D" Load and execute DEBUG. 

CMD"D"<ENTEK> 

This command causes DEBUG to be loaded and executed. To return to the 
point from which you entered DEBUG, type "G<ENTER>". 



CMD»E" Disk I/O error. 

CMD"E"<ENTER> 

This command will cause a brief explanation of the last DOS error code to be 
displayed. 



CMD^K^ Zero array. 

CMD^vvfOLO...)) 

vv = Any valid variable name 

This command will zero the array vv(diml,dim... ]) where dim refers to the 
originally dimensioned values of the array. All elements of the array will be 
set to zero. 
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EXAMPLE: 

(1) 100 DIM A%(6,7,4) 

110 More program lines 

4 

... 

690 More program lines 
700 CMD "K* A9o(0,0,0) 
710 More program lines 

In the example above, A% was dimensioned as a 280 element array. 
After line 700 is executed, A% is still a 280 element array and 
each element has the value of zero. 



CMt>n." Delete array. 

CMD"L"vv(0|,0...]) 
vv = Any valid variable name 

This command will delete the array vv(dim[ dim...]) and free the memory 
space for SUPERBASIC use. After using this command you can redimension the 
array. 

EXAMPLE: / 

(1) 100 DIM A%(6,7,4) ,' 

110 More program lines 

* 

690 More program lines 
700 CMD »L« A% (0,0,0) 
710 More program lines 

In the example above, A% was dimensioned as a 280 element array. 
After line 700 is executed, the array A% no longer exists and the 
amount of free memory is increased. 



CMD , M* Move program line. 

(1) CMD"M"line1,line2<ENTER> 

(2) CMD^MineVKENTER) 

(3) CMD»M".,line2<ENTER> 

This command will relocate llnel to Iine2 deleting linel from the program 
text and inserting it as Iine2. If Iine2 existed prior to this command, it will 
be replaced by the new Iine2. The "." may be used to refer to the current 
line pointer. 



CMD'N* Duplicate a program line. 

(1) CMD"N»line1,line2<ENTER> 

(2) CMD"N"linel,.<ENTER> 
(3). CMD«N".,line2<ENTER> 
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This command will copy Unci to Iine2 while leaving llnel Intact if •• o 
existed prior to this command, it will be replaced by\he „e w" n^. 't, 'Vj 
may be used to refer to the current line pointer. 

CMD^O 1 Open an additional file buffer. 

CMD"0 B 

This command allocates an additional file buffer. When SUPFRBA^ir i 
initialized it a.locates space for three file buffer. If y^ caused ffleb^f 
to be al.ocated at Initialization, only that number h "been re served CMD-o" 
allows you to allocate additional buffers from the direct mil. i « f? 
from within your program. The RAM locat Ion indicating h ? nlJ" \ °' 
buffers is 521AH (21018D). DON-T POKFin """"""* the number of open 

Don't execute this command from within a subroutine or a FOR-NEXT loop. 
EXAMPLES: 

(!) From the direct mode, the following command Is typed: 

CMD"0"<ENTER> 

^r?, ri , .",. ,n ;,.r "".** rwdT:..':';? a " oc r d ' w,,h most •*"""•• 

not be retained. ' '"' St ' ,ng «»'*nments, and DEFFN will 

(2) Using CMD-O" within a program 
10 DIM A(20), B$(15) 

200 CMD "0" 

210 OPEN "R-.VTESTFILE/TXT" 

Line 200 allocates a file buffer which is opened in line 210 

(3) 100 If X>15 then 300 

110 ON ERROR GOTO 900 
120 OPEN "E\X,B$ 

300 PRINT "MAXIMUM § FILE BUFFERS OPEN":END 

900 IF ERR = 104 THEN CMD-O" ELSE PRINT ERR/7 + 1, Fun 
910 RESUME 120 ERR/2 + 1: END 

The above error trap will cause additional file buffers to be 
allocated-each time lines 100-120 are executed. 

i 4 ach T t im e Pe t n he fi ^ """"^ Wfth ° Ut •»•»«'"« additional ones 
each t.me the program „ run, the following line could be used: 

15 If PEEK(4S21A)<5 THEN CMD-O": GOTO 5 
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CMD'Q" String sort. 

(1) CMD"Q",n1,vv$(0) 

(2) CMD«Q",n1,vv$(0,0),n2 

vv$ = Any valid array variable name 

nl = An integer or Integer variable representing 

the number of elements to be sorted. 
n2 = A positive integer or Integer variable 

representing the column number to sort in a 

two dimensional array. 

This new command will provide for a quick sort of a string array. Typically, 
a 1000 element array will take less than seven seconds to sort. * 

The sort is performed in accordance with the- sign of nl. If nl is positive, 
the sort will be In ascending or alphabetical order. If n1 is negative, the sort 
will be in descending or reverse alphabetical order. 

VERSION (1) is used to sort a single dimensioned array. The array will be 
sorted up to the nlth element, Including the 0th element. Version (2) is used 
to sort a two dimensional array with n2 indicating which column of the array 
to use as the sort key. 

EXAMPLE: 

10 CLEAR 600: DIM A$(10) 

20 FOR I = 1 to 10 | . 

30 READ AJ(I) 

40 NEXT I 

50 DATA "WASHINGTON", "OREGON", "CALIFORNIA", 

"NEVADA", "IDAHO", "UTAH", "ARIZONA", 

•MONTANA", "WYOMING", "COLORADO" 
60 CMD"Q",l,A$(0) 
70 FOR 1=1 TO 10 
80 PRINT A$(l), 
90 NEXT I 



The printout will be as follows: 



ARIZONA 


CALIFORNIA 


COLORADO 


IDAHO 


MONTANA 


NEVADA 


OREGON 


UTAH 


WASHINGTON 


WYOMING 







NOTE the following key points of the EXAMPLE: 

1. The 0th element was not used (it is a null string). 

2. The value of I in line 60 is actually 11. CMD"Q" will not cause an error If 
the value of nl is greater than the first dimension of the array. 
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3. If only line 60 were changed to: CMD»Q",-I.A$(0) 
the printout would be as follows: 

WASHINGTON UTAH. OREGON NEVADA 

'V^A IDAHO COLORADO CALIFORNIA 

«d" A$nSP' d " " WY0M ' NGR? ,t,J ,n the °'h element. A$(0)«>W YOMING- 

4. If only line 60 were changed to: CM D"Q »,6, A $(0) 
the printout would be as follows: 

CALIFORNIA IDAHO NEVADA OREGON 

UTAH . WASHINGTON ARIZONA MONTANA 

WYOMING COLORADO 

T*mn\ , e, ?! n J $ AH V thr ° Ugh A${6) Were Sorted ' '"»»"« A$(7) through 
A$(tO) as loaded from the data statement. ".rougn 



CMD«R« Enable interrupts. 

CMD"R"<ENTER> 
This command enables the interrupts. 

CMD"S« Return to MULTIDOS. 

CMD ,, S"<E.NTER> 
This command returns you to the MULTIDOS OPERATING SYSTEM. 

CMD»T" Disable interrupts. 

CMD«T"<ENTER> 

This command disables the interrupts. This command MUST precede any 
cassette operation. ¥ *<. cac any 

CMD«V" Scalar variables. 

CMD"V»<ENTER> 

ZV e Z7" d th Wm dJSPUy iU 2SSlgned «"■" - r,ab '« »d string equivalents 
• n the order they were created. 

Page 48 






SUPERBASIC 



The screen will clear and up to 12 variables will be displayed. Press any key 
to display an additional variable or <ENTER> to display up to 12. This 
function is complete when you receive the "READY" prompt. However, you 
may embed this command inside a BASIC program, which will require' user 
intervention for program continuance. 



CMD"X" Transfer to LEVEL II. 

CMD«X"<ENTER> 

This function will transfer the resident SUPERBASIC program to the LEVEL II 
BASIC environment while retaining memory protection and a printer driver 
pointer, if different than MULTIDOS's. in addition, It will seed the "DEBUG 
AREA" (starting at 4060H) with a semi-recovery program to aid in return to 
the DISK BASIC environment. Refer to "BASIC #" for direction on reentry to 
SUPERBASIC from LEVEL II BASIC. 

This command can be very useful if you want to work on a program which 
will normally be run in a LEVEL II environment. You can develop the program 
in SUPERBASIC, test it in LEVEL II, and return to SUPERBASIC. 



CMD*uuuuu" Execute a MULTIDOS function from SUPERBASIC. 

i 
CMD"uuuuu n <ENTER> 

uuuuu = Any valid MULTIDOS command 

This command allows you to use any valid MULTIDOS command, including 
BASIC, from within the SUPERBASIC environment. The command can be used in 
the direct mode or as a statement within your BASIC program. Your program 
will be protected while the command is being processed. You can even use 
complex MULTIDOS commands, such as loading and executing machine language 
programs provided those programs use TOPMEM (4049H) as the upper memory 
limits and will fit into the remaining RAM. This command requires a minimum 
of 6330 free bytes to execute. 

EXAMPLES: 

(1) CMD"DIR" 

The directory contents will be displayed. 

(2) CMD"SAUCERS/CMD" 

The machine language program "SAUCERS/CMD" will be loaded and 
, executed. If the program does not use protected memory, and if it 
exits via location 402DH then your BASIC program will resume 
execution at the next line number. 

(3) CMD"EA/CMD" 

The Editor/assembler will be loaded and executed. Upon completion, 
your BASIC program will resume execution at the next line number. 
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SUPERBASiC 
DEF FN Define function. 

DEFFNxxx(uuu{,uuu...])=www 

xxx = Name of the function and is any valid variable name. 

uuu = Variables used by the expression. 

www = An expression or formula usually involving the varlable(s) 
(uuu) passed on the left side of the equal sign. 

I« IlVnTfi '? V ° U Cr " te y ° Ur 0W " ,mp " C,t functlon ' Aft <r * funct, °" 
has been defined, you use the function as any of the other intrinsic 
functions, e.g., ATN, COS, ASC, etc. intrinsic 

The type of value returned will be the same as the type of variable used to 
name the function. In addition, the variable, used in the DEFFN statement 
have no effect on the value of that variable. ' 

EXAMPLE: 

10 DEF FN Q(K,L) = K/2 + L/1 

20 INPUT "Enter quantity of nickels and dlmes";N,D 

30 PRINT "The amount in dollars ls B ;FN Q (D,N) 

Hi 3u nC are 0n N Q an ( d F D L " *T'* V^ * " d ^ b " 1 the " riibl « '" <"« 20 
on fI n a cm ~ L miy bC U$ed in th ° P f °8 ram "d have no effect 

"riable?* Tand l! TH Q defin ' t,0n US ' ng K " d L *"< »' «"«' •* the 
e«.p«.b.e ,y ax ^ betW " n ° EF lnd FN h ^^ DrF ™ •» 



DEFUSR Define entry address of USR routine. 

DEFUSRn=aaaaa 
n - The digit 0-9. If n is omitted is used. 

aaaaa = The entry address to a machine language routine, 
aaaaa may be any numerical expression, including 
constants, variables, or functions. 

EXAMPLE: 

10 CLEAR 500: DEFINT A-Z 

20 N = 8000 

30 DEFUSR 5 = N • 4 

Defines 32000 "decimal to the USR 5 call. 
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INSTR String search. 

INSTR([p ] string, substring) 

' p = Position in the string where the search is to begin. 
string = The name of the string to be searched. 
substring = (1) The name of the substring for which you are 
searching, or 
(2) The actual substring for which you are searching 

This function searches through "string" to see if it contains "substring". If it 
contains "substring", INSTR returns the starting position of "substring" in 
"string"; otherwise zero is returned. 
If "substring" is a null string, INSTR returns zero. 

EXAMPLES (let Z$="SUPERBASIC\ W$="", X$="SUPER") 

Express i on Resul t 

INSTR (Z$,"PER") 3 

INSTR (Z$,"TRS") 

INSTR (2,Z$,W$) 

INSTR (3,Z$,«U") U 

INSTR (Z$,X$) 1 

INSTR (2,Z$,X$) 

INSTR (4, 1%, "BASIC") 6 

INSTR (3,"ABCDABCDABCDABCD","ABC") 5 



LINEINPUT Input a string from keyboard. 

LINEINPUT[ "message"; jvv$ 

message = A prompting message 
vv$ = A valid variable name 

This BASIC statement allows you to input a complete line from the keyboard, 
including punctuation, and line feeds. A space is permitted between LINE and 
INPUT (LINE INPUT). This statement nulls the variable, does not print a 
question mark, allows the entry of only one string variable, and recognizes 
leading spaces. 



LIST Display program text. 

" LIST<ENTER> 

This command has been modified to show graphic characters Included in 
quoted text. You will not get a string of BASIC reserved words. The actual 
graphics will be displayed. Editing of these packed strings is allowed, as long 
as the "A" command is not used. (If you accidently enter an "A" command, 
use the "Q" command to abort it.) 
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MID$» Replace portion of a string. 

M 'D*(w$ f p[,c])=rr$ 

vv$ = The- variable string to be changed. 

e I iVontlTj P ° Sl:SOfi W!lhi " thC $trln * for the replacement. 
rr$ = The replacement string. 



EXAMPLES (let C$="1 2345678", D$=»BASIC«) 



Express Ion 

MID${C$,3,4)a«ABCDE- 
M'D$(C$,!,2)=0$ 
SVU'D$ (C$,5)="Y2 , » 



Resul tant C$ 

1 2ABCD78 
BA345678 
1234YZ78 



TIME* 



Get current RAM date and time. 

This is a BASIC function which returns in a 17 hv„ .,,i 

in the form MM/DD/YY HH:MM:SS *' th<5 t,me and > da 



te 



USRn Execute a machine code routine. 

USR[n](val) 

».!" "4 A . n iT er fr ° m ° " 9 * ThC defaU,t va,ue '» 0. 
- An Integer or .nteger variable with value 
from -32768 to +32767. 

This command transfer* .- ««♦,-! . 

r;«"p:o 8 u 4" '™'v™;;«r; ■:. • r-r' superbas,c «•••••» 

corresponding DEFUSR ute-nen ilk . ' »"•«"'«" 0* the 

complete, , ia , RE " " ,» n.a! V , "" "" 'P«cf.led USR function i, 

'»• HL re 8 ,„er „.„. To re eiVe T„ " f™ ^"'uV. ""/•'"• " "" l * " 
conum „,„ value whe „ SUPERBASIC con, „„es , "" V "" b " ""' 
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The last llSR subroutine will have the LSD entry point in 408EH- 16526 dec 
and the MSD entry point in 408F - 16527 dec. The USR function in 
SUPERBASIC, places the address here, then returns to RQM to execute the 
subroutine. You can circumvent the extended USR function b»> POKING a C9H 
201 dec into RAM location 41A9H- 16809 dec . (This is the value for 
LEVEL II But has a C3H - 295 dec for the extended USR function). Next poke 
your subroutine's address into 16526 dec and 16527 dec to execute a LEVEL II 
program with USR calls in SUPERBASIC. Add the instruction: POKE 16809, 201 
prior to executing the USR subroutine. 



SUPERBASIC overlay utilities. 
FIND Find ASCII characters. 

Ftar<ENTER> 

This command will find all occurences of "tar" in your BASIC program. Spaces 
are recognized with this command. 

EXAMPLE: 

F in <ENTER> 

This will FIND all occurences of " in " in the resident BASIC program. The 
display will indicate the line the "tar" is found on, and if more than one 
occurences are on this line a "/" is printed followed by the number of 
occurences. 

EXAMPLE: 
F:<ENTtR> 

10 20/5 50 70 90/3 

The ":", colon, character Is in line 10 once, line 20 five times, line 50 once, 
line 70 once, and in line 90 three times. 



GLOBAL EDITING (GE) - Mass editing BASIC program. 

-<ENTER> 

This SUPERBASIC feature will permit you to perform surgery on your BASIC 
program. You can change variable names, items in a data list, integers, 
strings, etc. You can create compressed strings, merge lines, split lines, 
change reserved words, and more. 

Tlve following types of operations are ariowed: 

- Change all or part of variable names. 

- Change all or part of constants, data list items, or strings. 

- Change graphic codes as »CHR((x)" into packed strings (x = 128-191). 

- Change space compression codes as "CHR$(y)» into packed 
strings (y = 192-255). 
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Merging of adjacent line numbers into one long line. 
Splitting of one long line into two shorter ones. 
Change reserved words. 



GE - Genera! changes: 

To use the utility: 

(la) From the MULTIDOS ready mode: 

Load SUPER8AS1C and your program, e.g. BASIC LOAD n program"<ENTER> 

(lb) From SUPERBASIC: 

Load your BASIC program, e.g. LOAD"program n <ENTER> 

(2) Enter the global editor by issuing the command: "-<ENTER>" . 

The screen will be cleared and the following message will be displayed: 

Line Target 

T = 
This is the target (T) entry mode. Enter a target as follows: 

To change a constant, a variable name, or Item in a data list which is not 
enclosed in quotes, respond with the item when the target Is requested. The 
response must be from 1 to 255 characters long, and must be terminated with 
the <ENTER>. 

To change a target which is enclosed in quotation marks, precede the target 
with the $ sign. The target must be from 1 to 254 characters and must be 
terminated with the <ENTER>. 

To change only a single character variable, while leaving multi character 
variables with the same letter unchanged, enclose the target single character 
within single quotes ('X'). 

To change only the first character of a multi character variable, enter the 
target character followed by a single quote (X 1 ). To change the second or 
greater character of a multi character variable, while leaving the first 
character unchanged, precede the target single character with a single quote 
(•X). 



GE «- Changes to reserved words: 

The global editor will allow you to change reserved words, such as ■PRINT" to 
"LPRINT". You must be careful, however, as lowercase is not acceptable. 
Under SUPERBASIC or LEVEL II BASIC, as each line is entered or edited, it is 
processed through a buffer. This buffer looks for reserved words and changes 
them to a one byte code, it also converts ail variables to uppercase. Since 
the global editor does not process changes through this buffer, do not use 
lowercase for reserved words or variables as a syntax error will occur at run 
time. If your target is a reserved word or the arithmetic operators +, -, •, /, 
up arrow, >, = or <, bracket this target with the ■< & ■>" characters, i.e. 
< + >. 
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Aftcr you have entered a target according to the rules above, you will be 
prompted to enter Line A, which is the first line to search and has a default 
value of your first program line. You will next be prompted to enter Line B, 
which is the last line to be searched and has a default value of the last line 
of your program. Line A and Line B permit you to limit a change to a 
specific range of program lines. 

Next you will be prompted to enter the replacement for the target specified. 
To re-enter the target if you entered it in error, use the <ENTER> character 
as the replacement. You will be returned to the target entry mode. To delete 
all occurences of a target, use the <SHIFT>@ as the replacement. 

Finally, you will be asked if you want the above global changes to be made. 
This is your last chance to correct an error in your entries. Respond n Y" to 
the query "Use (Y/N)? fl if you want the changes made. SUPERBASIC will then 
search your program for the target and make the changes. The screen will 
show the line number being searched under the title "Line" and the last line 
number where a target was found under the title "Target 1 '. SUPERBASIC will 
display a total of the target occurences to indicate completion. 

To exit from the GLOBAL EDITOR press <ENTER> aftei a successful chang? or 
piess <BREAK> at the target r replacement queries. 

EXAMPLES: (> means changes to, T= is the target, and R= is the replacement) 

(1) To change all occurences of the variable n B" to 

»F", T = B and R = F. 

B>F, AB>AF, BA>FA, BB>FF, BOFC, BD>FD, B$>F$, 
AB$>AF$, A$(AB)>AJ(AF) 

(2) To change all occurences of a single "A" to "G", 

T = »A' and R = G. 

A>G, A$>G$, A$(1)>G${1), A$(A)>G$(G), 
A$(AA)>GJ(AA) 

(3) To change all occurences of the first "A" in a 

multi character variable to "H", T = A 1 and R = H. 

AA>HA, AB>HB, AOHC, AD>HD, AE>HE, AA$>HA$, 
AB$>HB$, A$(AA)>A$(HA), A$(AB)>A$(HB) 

(4) To change all occurences of the second "A" in a 

multi character variable to "I", without 
changing the first occurence, T = 'A and R = I. 

AA>AI, BA>BI, AA$>AI$, A$(AA)>A$(AI) 

(5) To change all "E" in strings to "Z", T = $E, and R » Z. 

"ABCDE"> B ABCDZ" 
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GE - Building compressed strings: 

If your program contains many "CHR$(x)+CHR$(x)« statements, the global 
editor will shorten ft by building a compressed string. This can result in 
faster execution and more free memory. As an example, the line: 

10 A$=CHR$(191)+CHR$(129)+"X«+CHR$(176) 

would require 32 bytes of memory. After the global editor built a compressed 
string, the line would be: 

10 A$=»..X. B 

where the *.* represents a graphic character. The new length would be 14 

bytes , or more than a 50% saving of space. 

To build a compressed graphics string in place of CHR$(x) type lines, enter 
the "+■ character for the target. 

fa build a compressed string with space compression codes, enter the "*" 
criracter for the target. 

Ths CHR$(x) OR CHR$(y) cannot contain blanks within the parentheses. 
€KE$( 191 ) is not acceptable and will not be changed. 

NOTE: The changed code will display properly. SUPERBASIC will also list it 
properly to the screen. However, since it is compressed code or graphics, it 
will not look the same when it is sent to a printer which does not have 
graphics capabilities. 

EXAMPLES: 

{1} ■♦■ Changes 210 B$=CHR$(1 31)+ B X»+CHR$(1 76) 

to 210 B$=".X.« Where ".^graphics. 

(2) ■•■ Changes 337 PRINT CHR$(204)+"TEST" 

to 337 PRINT B TEST" 

(3) "+» Followed by the ■•» 

Changes 400 A$=CHR$(1 78)+CHR$(204)+CHR$(1 90) 
to 400 A$=». ." 



GE - Merging line numbers: 

The global editor will allow you to merge or append a program line to the 
preceding line in your program. It does not change references to the line. As 
an example, if your program contained lines 1,2,3,4, A 5, and you merged line 
3 to line 2, then an error would result at run time if line 5 originally 
contained "G0TO3". This is because line 3 no longer exists. Do not append to 
a line which contains an open quote (10 A$="THIS IS). Close the quote first, 
then merge (10 Ai="THIS IS"). 

This function will allow you to create lines greater than 255 bytes in length. 
The lines will execute properly, but can neither be properly listed on the 
screen nor edited. 
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To use this merging function, respond with the ■/" character and the line 
number to be merged as the target. 

EXAMPLE: 

10 A>="TEST #" 
20 PRINT A$ 

To merge the above two lines target Is /20. 
The result is one line as follows: 

10 A$="TEST jT:PRINT A$ I 



GE - Splitting lines: 

The global editor will allow you to split a program line containing two or 
more BASIC instructions into two lines. The new line number can have any 
number greater than the line to be split and up to 65529. However, if you 
assign a new line number greater than the next line after the line to be 
split, run time errors can occur If you make references to those in-between 
lines. As an example, if your program contains lines 10, 20, 30, 40, 50, & 60, 
and you split line 20 into lines 20 and 45, lines 30 and 40 will not be be 
found by any reference instructions such as "GOTO 30", "GOSUB 40", etc. 
However, if the program flow is such that BASIC would normally process the 
next statement in RAM after the new lines 20 and 45, lines 30 and 40 will 
be processed. BASIC would, in the absence of any branching instructions, 
process lines 20, 45, 30, 40, and 50 in that order. 

The split point must be directly behind a colon (:) in the program line. To 
use the split function, the target is in the form -ttt where ttt is the target 
for the split. If the target is a reserved word such as "PRINT", enclose the 
target with "<" AND ">" signs. If no target is specified, the line will be split 
at the first colon. Line A now represents the line number to be split and line 
B represents the new line number. 

EXAMPLES: 

(1) 10 A$="TEST #":PRINT A$" 

To split the above line, T = -, Line A = 1 0, Line B=1 5. 

The result is: 
10 A$=»TEST #" 
T5 PRINT A$ 

(2) 30 A$="ABCDE":PRINT A$:B$="FGH»:PRINT B$ 

To split the above line at «:PRINT B$", 
. T = -<PRINT> B$, Line A = 30, AND Line B = 35. 
The result Is: 

30 A$="ABCDE":PRINT A$: B$="FGH" 
35 PRINT B$ 
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The global editor executes very rapidly. The creation of compressed strings 
requires 67 iterations each time, so the "*■ and "+" functions will operate at 
a slower speed. During operation, the editor will display the line being 
searched at the top of the screen. It wiU also display the line in which the 
target was last found. 

Be cautious about changing variables In a "DEF" statement. The range must be 
asssnding. If the replacement is larger than the target, your program will be 
increased in size by that difference for each occurence. If you run out of 
jfterrsory ,an "Out of MEM* error message will be displayed. At this time all 
changes up to the point where memory was insufficient will be made. If this 
occurs there is stMi sufficient memory to reverse the changes or to make 
other changes which would decrease the program size. 



REFERENCE Cross reference variables and Integers to 9999999. 

;lp][xxx]<ENTER> 

p = "•■ if the reference listing is to be displayed on the screen 
or n $ n if the reference listing is to go to the printer also. 
NOTE: p is optional. 

xxx = Reference target which may be: 

(1) A one or two character variable name without 

a type suffix. 

(2) An integer number which may be a line number 

or a value used in the program. 

(3) A reserved word if preceded by a | symbol. 

Taiget version (!) will show all line numbers which contain the variable 

specified. Target version (2) will show all line numbers which refer to the 

integer specified. The reference may be as an Integer in the line or to a line 

number. Target version (3) will show all line numbers which contain the 
reserved weed. 

After a reference target has been made, you may display those lines by 
pressing the »;" key. Each line referenced will be displayed sequentially and 
ma'- be edited before the next line is called. 

* of the p option without a xxx target will result in a reference listing of 
. integer numbers and variables. If the p option is used with a xxx target, 
reference listing will be produced starting with the target and proceeding' 

ascending order. If the reference listing is requested in the form 
•<#<ENTER>", a listing of reserved words will be produced. The reserved 

d listing is- produced in the order ROM-BASIC "TOKENIZES* (converts to 
mpressed storage) the reserved words. This is not alphabetical order. 

3 pause during a reference listing, press shift @. To resume the listing, press 
any key. To aoort the reference listing, <BREAK>. 
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EXAMPLES: 

(1) ;»<ENTER> 

All integer and variable references are displayed on the serpen. 

(2) ;K<ENTER> 

All references to the variable "K" are displayed on the screen. 

(3) ;$G<ENTER> 

All variable starting with "G" and continuing through n ll* will 
have their references directed to the line printer. 

(4) ;#PRINT<ENTER> 

All line numbers which contain the reserved word "PRINT" will 
be displayed on the screen. 

(5) ;$#<ENTER> 

All reserved words will have their references directed to the line 
printer. 

When a reference is displayed or printed for- any target, the line number 
containing the reference is displayed and may be followed by one or more of 
the following modifiers: 

/n where n = the number of references to the target 

within that line. 
/$n the variable contains the string designator "$". 
/ion the variable contains the integer designator "9o". 
/In the variable contains the single-precision designator "I". 
/#n the variable contains the double-precision designator "#". 
( the variable is used as an array variable In this line. 

RENUMBER Renumber a BASIC program. 

(1) :<ENTER> 

(2) :o[nn][,lii](,sss][,eee]<ENTER> 

This function will allow you to check for missing or invalid line numbers 
within your program, recover a "NEWED" program, and renumber all or part of 
your program. 

To check for errors use format (1). SUPERBASIC will scan your program for 
reference operators (GOTCs, GOSUB's, ON's, ERL's, etc.). It will look for missing 
line numbers, and overflow or Improper line numbers. 

When format (1) Is used, the message 'ONLY CHECKING FOR ERRORS' will 
appear on the screen. If any errors are found, the message 'Error(s)' will 
appear, followed by the line number causing the error and the error type. If 
no errors are found the message *Function completed' will be displayed. 
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Error types are: 



I 1 1 1 1 /U(nnnnn) Line number Mill Is referenced in 

line number nnnnn but does not exist. 

I 1 1 ! ! / S Linen urnb sr !!!!! contains 2 syntax error. 

Illll/O Line number Mill contains an improper 

I ine number (>65529). 

To recover a program immediately after you have typed "NEW, use FORMAT 
(1). This will force a rescue of the program. If you establish a variable 
between the "NEW" and the ■:", the results are unpredictable, and probably 
will not be what you wanted. To renumber your program, or parts thereof, 
use format (2) as shown above where: 

nnn = The first line number to be assigned to s renumbered 

line, nnn must be in the range of To 65529TThe 

default value is 10. 
iii = The increment to be used in renumbering. The default 

value is 10. If used, iii must be preceded by a comma. 
sss = The starting point in the original program where 

renumbering is to occur, sss must be <= nnn and 

has a default value of 0. 
eee = The ending point in the original program where .line 

renumbering is to stop, eee must be >= sss and has a 

default value of 6SS29. 

SUPERBASIC will check your program for errors before attempting- to 
renumber. If any errors are found they will be displayed and control will be 
returned to you with your program unchanged. 

EXAMPLES: 

Sample program 

10 PRINT "TEST" 

20 GOTO 290 

30 INPUT A 

40 ON A GOTO 10,20„60,70 

50 GOTO 10 

60 PRINT A 

70 PRINT A«2 

80 GOTO 70000 

90 END 

(1) The command n :<ENTER> B would generate the following messages: 
•Only checking for errors 
Error(s) 

290/11(20) 40/S 80/O 
Function completed 



% 



READY f 

> ' 
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(2) After fixing the above errors, the command 

":50,1,50,70<ENTER>» would generate the 
following renumbered program: 

* 10 PRINT "TEST" 
20 GOTO 90 
30 INPUT A 
40 ON A GOTO 10,20,51,70 

50 GOTO 10 

51 PRINT A 
70 PRINT A*2 
80 GOTO 10 
90 END 



SUPERBASIC file manipulation. 

KILL Delete a file from a diskette. 

KILLvar$ or KILL»filespec" 

var$ = a string defined as a fllespec. 
filespec = a file specification for an existing file. 

This command allows you to delete a file from the directory. If the 
statement is within the program, you must be sure to close the file first. 
From the command mode, SUPERBASIC and MULTIDOS close all files before the 
directory is changed. 

LOAD Load a BASIC program to RAM. 

LOADvar$[,R] or LOAD"filespec"[»R] 

var$ = a string defined as a filespec. 
filespec = a valid BASIC program file name. 

This command allows you to load a BASIC program from diskette. The »,R» 
option will load and run the program without closing any previously open 
files, which were opened via an OPEN statement. 

MERGE Combine two programs in RAM. 

MERGEvarJ or MERGE"filespec" 

var$ = a string defined as a filespec. 
filespec = a BASIC program saved using the ASCII option. 

Il.is command combines two program segments within SUPERBASIC's memory 
space. The program lines in varl will be inserted into the resident program in 
iequent.al order. If line numbers in varl coincide with a line number in the 
resident program, the resident line will be deleted. 
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NAME Load an execute a program keeping variable values. 

NAMEvar$[,R] , or NAME"filespec"[,R j 

This command is SUPERBASlC's chaining function. It allows you to run BASIC 
programs which are too large to fit in memory. This command will cause 
SUPERBASIC to load and execute the file var$ or filespec beginning with the 
lowest line number as if It were a new BASIC program. The previous variables 
will remain Intact, except for DEFFN, strings created via READ, or string 
assignments directly In a BASIC program. If the ",R B option is specified, the 
files will remain open. 

RUN Load a BASIC program and execute. 

i 

RUNvar$i,R] or RUN"filespec"[,R j 

This command allows you to load a BASIC program from diskette and 
immediately execute the program at the lowest program line. 

SAVE Save BASIC program onto diskette. 

SAVEvar$[,A] or SAVE»filespec' i [,Al 

This command allows you to transfer the current BASIC program onto the 
diskette in compressed format. The "A" option will cause the program to be 
stored in ASCII format. Compressed programs load faster than ASCII programs 
but cannot be intelligently listed from MULTIDOS. 



SUPERBASIC - File Access. 

OPEN Sets the mode and assigns filebuffer to a filespec. 

(1) OPENmode,buf,var$ 

mode is a string or constant, and is one of the following: 
mode access mode 

D RANDOM I/O to an existing file. 

E SEQUENTIAL OUTPUT to an existing file. 

I SEQUENTIAL INPUT from an existing file. 

- O SEQUENTIAL OUTPUT to a file. 

R RANDOM I/O to a file. 

buf = equivalent to the file buffer which will be assigned to 

■var$". buf value MUST be 1 to »ff", whereas "ff H is the 
number of file buffers opened during SUPERBASIC 
initialization, 
varj = a string defined as a filespec. 
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(2) OPENmode,buf,var$,udl 

mode is "R", and udt = user defined record length. 

(if mode = "D", udl is Ignored, but no error is generated.) 

EXAMPLES: let N = 2, Q* = -IOTA", P$ = "CHECKING/TXT". 

OPENQ*,N,P$ 

Opens the file "CHECKING/BAS" for sequential input into fil: 
buffer 2 (The file MUST exist). 

OPEN«0'»,3,"BALANCE/TXT n 

Opens the file "BALANCE/TXT", sets the pointer to the beginning 
of the file, and assigns file buffer 3 to the file. 

When the "0" mode is used, if the filespec does not exist, it will be created 
with the pointer (naturally) set to the beginning of the file. Nevertheless if 
the file existed or not, the "O" mode will set the pointer to the beginning' of 
the file; whereas the "E" mode will set the pointer to the end of file "EOF" 
file? 6 fUC d0 " " 0t CXiSt '" 0PtN " E ''' the " E0F " wi " be the beginning' of the 

Only one file buffer may be assigned to the «D", "E", "0", and «R« modes, 
whereas the ■!■ mode may have two or more. I addition, a file buffer may 
not be assigned to more than one filespec at a time. 

CLOSE Unassign a file buffer by buffer number. 

CLOSt|#J|bufI,buf...Jl 

buf = an expression with a value of 1 to 1 5. If buf is omited, 
all open file buffers will be closed. 

EXAMPLE: 

CLOSE # 3 Closes file buffer 3. 

CLOSE 8,2,4 Closes file buffers 2, 4, and 8. 

CL0SE T Close file buffer equivalent to 

the value of *T". 
Anything which generates a CLEAR statement directly or as a subroutine will 
close all files. The following will close all files: NEW, LOAD/RUN (without 
",R"), MERGE, EDITing a program line, and CLEAR. 

INPUT* OPEN"l« read command. 

INPUT#buf,varI,var...] 

buf = file buffer 1 to 15. 

var = a variable name to contain the data from the file. 
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L1NE!NPUT# OPEN"l» read a string to ODH (13 dec). 

LINEINPUT#buf,var$ 

buf - file buffer 1 to 1 5. 
var$ = the variable name to contain the string. 

L!NEINPUT# will read all characters from the current position up to and 
including a ODH (not preceded with an OAH), up to the end of file, or 255 
characters - whichever comes first. 

PRINT* OPEN»0" and OPEN"E B write command. 

PRINT#buf[USINGformat$;]item[m item...) 

q m j ™ 2 tisc o is t t s t 8 So i 3© 
format = a sequence of field specifiers used with USING, 
m = a delimeter placed between "items". 
item = an expression to be evaluated and written to the diskette. 

The ■item 1 ' delimeter, "m", can be a semicolon ■;" or comma ","• The use of 

these delimeters will determine the format on the diskette. If the comma is 

used, .the "items" will be zoned in 16 byte areas on "the diskette. This 
consumes diskette space rapidly. 

FIELD OPEN"D" and OPEN"R» file buffer organizer. 

FIELD( #]buf,len1 AS str1$[,len2 AS str2$...| 

buf = a file buffer 1 to 1 5. 
lenl = the length of the first field. 
str$1 = the variable name of the first field. 

Ien2 = the length of the second field. 
str$2 = the variable name of the second field. 

... = subsequent len AS str$ pairs for the balance of the buffer 
size. The size is determined by the user for created files 
or by the file itself for existing files. 

All of the data items for RANDOM I/O is defined as strings. To convert 
numeric data to a string, the following functions are used: 

MKI$(num) num is an INTEGER number. 

lvKS$(num) num is a SINGLE PRECISION number. 

MCDKnum) num is a DOUBLE PRECISION number. 

The length of the string is determined by the precision of the convert 
function. MKI$ creates a 2 byte string, MKS$ creates a 4 byte string, and 
MKD$ creates an 8 byte string. 
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l^.rd.r ,. cc„v„, ,„. ilrl „ E blek „ . „ umber _ ih# )oi|owine (un£[ions ^ 

CVI(str$) . trt i. , - 

CVS itri ! ! 2 ° f neater byte string. 

C ^ (Str$) $tr * '* * 8 or greater byte string. 

Procedure to write to a RANDOM file. 

""««* Set .'.'""fen '.rV" 7" "*, ""'"' in, ° "" "'■ »■"•' T " 

u» Ljti and kset are used to place the "stri" used in the Finn 
statement into the assigned file buffer. LD 

LSETstr$ = exp$ ~— 

RSETstrJ = exp $ 

str$ = a FIELDed variable name, 
expt = the assignment for str$. 

The command LSET will left justify the "exo$« into th* Ram 

by "str$». The RSET cnmmanrf •„.*?* the RAM s P ace Pointed to 

pointed to by .„r $ J *'" """ ,USt ' fV """" ,nt0 the RAM *P»< 

RS E\ E: wnrX^s n sL be "i: D t a "' 8ned , t0 3 RAND ° M fHe buf,Cr ' » h -» "ET or 
here!!! rCa "' En CXp$ l0 this strin *' I just gave ydu a little rope 

LSET and RSET will not increase the length of "stri" If »„ nt . • . 

■*tr$-. the characters to the R,GHT are truncated. ' P$ ' $ ^^ than 

PUT OPENED" and OPEN-R- write statement. 

PUTbuf[,recJ 

buf = a file buffer 1 to 1 5. 

r " = !» C use e d COr T d h. nUmber ' " fCC l$ ° m,tted ' thc Current '«ord 
s used. The current record is one unit greater than the 
last record written. 

(2) FIELD the buffer. 

(3) MKI$. MKS$, MKD$ as necessary. 

(4) LSET or RSET all data. 

(5) PUT the record. 



Page 65 



SUPERBASIC 
Procedure to read from a RANDOM file. 

..In order to read from a RANDOM file, the file must be OPENed first, then 
FFLDed per your requirements. The GET command will read a record into the 

.fife buffer. The "str*" in the FIELD statement will now have the equivalent of 
the contents \w r&tfofd^read. 

GET OPEM s B s and OPEN n R" record getter. 

■GETlft Ibuf|» ec] 

buf ~ v file butter 1 to 1 5. 

rec » the record number. If rec is emitted, the current record 

is used. The current record is one unit greater than the 

last record read. 

i 

File position indicators. 

SUPERBASIC has three file position indicators which can be used with 

OPENED' 3 ; OPEN"! 9 , an& OPEN"R s . 

EOF Esvd of file d ejector. 

EGF(fouf) 



This function returns a zero if the end of file has not been read. Otherwise 
a -1 is returned. 

LOC "File location indicator. 

•Loeiisuf} 

This function returns one unit higher than the current record read for 
€)PEN.«D ; ' an*"OPEN l, R". For OPEN"!", LOC returns one unit higher than the last 
sector read- (physical records). 

LOF Last record :indicztor. 

V LOF(buf) 

This function returns the highest record for OPEN"D" and OPEN"R". For 
OPEN"!", LOF returns the the highest physical record (sector). 
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